Coveo Machine Learning Models API

openapi: 3.2.0
info:
  title: Coveo Machine Learning Machine Learning Models 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: Machine Learning Models
paths:
  /rest/organizations/{organizationId}/machinelearning/models/{modelId}:
    get:
      tags:
      - Machine Learning Models
      summary: View a Model
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: getModel
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        description: The unique identifier of the target model
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Model'
      x-pretty-name: getModel
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models/paramId_get
    put:
      tags:
      - Machine Learning Models
      summary: Update the Configuration of a Model
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"EDIT","targetId":"*"}

        ```

        </details>'
      operationId: updateModelInformationById
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        description: The unique identifier of the target model
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Registration'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Information_To_Update_Model'
      x-pretty-name: updateModelInformationById
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models/paramId_put
    delete:
      tags:
      - Machine Learning Models
      summary: Delete a Model
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"EDIT","targetId":"*"}

        ```

        </details>'
      operationId: unregisterById
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        description: The unique identifier of the target model
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
      x-pretty-name: unregisterById
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models/paramId_delete
  /rest/organizations/{organizationId}/machinelearning/model:
    post:
      tags:
      - Machine Learning Models
      summary: Create a New Model
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"CREATE","targetId":"*"}

        ```

        </details>'
      operationId: register
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Registration'
        required: true
      responses:
        '201':
          description: Created
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Registration_Response'
      x-pretty-name: register
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: CREATE
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: CREATE
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/model_post
  /rest/organizations/{organizationId}/machinelearning/models:
    get:
      tags:
      - Machine Learning Models
      summary: List All Models
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: listModels
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: engines
        in: query
        description: A list of engine ids
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                uniqueItems: true
                type: array
                items:
                  $ref: '#/components/schemas/Model'
      x-pretty-name: listModels
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models_get
  /rest/organizations/{organizationId}/machinelearning/models/{modelId}/details:
    get:
      tags:
      - Machine Learning Models
      description: 'Get detailed information about a specific model<br /><br /><details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: getModelDetailsById
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        description: The unique identifier of the target model
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Model_With_Additional_Information'
      x-pretty-name: getModelDetailsById
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models/paramId/details_get
  /rest/organizations/{organizationId}/machinelearning/models/details:
    get:
      tags:
      - Machine Learning Models
      summary: Get Detailed Information About All Models
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: listModelsWithDetails
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                uniqueItems: true
                type: array
                items:
                  $ref: '#/components/schemas/Model_With_Additional_Information'
      x-pretty-name: listModelsWithDetails
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: VIEW
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/models/details_get
  /rest/organizations/{organizationId}/machinelearning/engines/{engineId}/models/{modelName}:
    delete:
      tags:
      - Machine Learning Models
      summary: Delete a Model
      description: '<details><summary>Privilege required</summary>

        ```

        {"owner":"COVEO_ML","targetDomain":"MODELS","type":"EDIT","targetId":"*"}

        ```

        </details>'
      operationId: unregister
      parameters:
      - name: organizationId
        in: path
        description: The unique identifier of the target Coveo Cloud organization
        required: true
        schema:
          type: string
      - name: engineId
        in: path
        description: The id of the engine
        required: true
        schema:
          type: string
      - name: modelName
        in: path
        description: The model name
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
      deprecated: true
      x-pretty-name: unregister
      x-required-privilege:
        owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-required-privileges:
      - owner: COVEO_ML
        targetDomain: MODELS
        type: EDIT
        targetId: '*'
      x-ui-operation-id: /rest/organizations/paramId/machinelearning/engines/paramId/models/paramId_delete
components:
  schemas:
    Registration_Response:
      required:
      - engineId
      - exportPeriod
      - intervalTime
      - intervalUnit
      type: object
      properties:
        commandLineParameters:
          type: array
          description: 'DEPRECATED: no longer supported as of Dec 2023'
          readOnly: true
          deprecated: true
          items:
            type: string
            description: 'DEPRECATED: no longer supported as of Dec 2023'
            readOnly: true
            deprecated: true
        commonFilter:
          type: string
          description: The filter to apply to the common event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: country=='United States'
        customEventFilter:
          type: string
          description: The filter to apply to the custom event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (customEventValue=='submitButton') AND (customEventType=='caseCreation')
        viewEventFilter:
          type: string
          description: The filter to apply to the view event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: viewContentType=@'product'
        engineId:
          type: string
          description: The id of the engine
          example: topclicks
        exportOffset:
          type: string
          description: The offset period to apply to the export. An undefined `exportOffset` means that the `exportPeriod` is based on the moment when the model was generated. An `exportOffset` of `P1W` means that the `exportPeriod` is based on the moment one week before the model was generated. If specified, must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1W
          deprecated: true
        exportPeriod:
          type: string
          description: The period to export data from. Unless an `exportOffset` is specified, the `exportPeriod` uses the moment when the model was generated as a base. Must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1D
        intervalTime:
          type: integer
          description: The number of `intervalUnit` between each run of the job, should be greater than or equal to 1
          format: int32
          example: 1
        extraConfig:
          type: object
          description: A JSON object representing the additional configuration to pass to a model configuration
          example:
            someKey: value
        intervalUnit:
          type: string
          description: The duration unit of the interval between each run of the job. See `intervalTime`
          example: WEEK
          enum:
          - DAY
          - WEEK
          - MONTH
        modelDisplayName:
          type: string
          description: The model display name in the Coveo Cloud V2 administration console
          example: MyModelDisplayName
        modelName:
          type: string
          description: The model name
          example: remove_me_model_name
        searchEventFilter:
          type: string
          description: The filter to apply to the click and search event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (originLevel1=~'search' OR originLevel1=~'listings')
        startTime:
          type: string
          description: A timestamp indicating when to begin the first job (in milliseconds since UNIX epoch format). If no start date is specified, the job starts immediately
          format: date-time
          readOnly: true
          deprecated: true
        versionMatcher:
          $ref: '#/components/schemas/VersionExpression'
        groupsThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        apiKeysThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        modelId:
          type: string
          description: The unique identifier of the target model
          example: My_Model_ID
        endTime:
          type: string
          description: The epoch date when the schedule will end. If there is no end date, the schedule will last forever.
          format: date-time
          readOnly: true
          deprecated: true
        platformVersion:
          type: integer
          format: int32
          deprecated: true
          enum:
          - 1
          - 2
        orgId:
          type: string
          description: The unique identifier of the target Coveo Cloud organization
          example: MyCoveoOrganization
        resourceId:
          type: string
          deprecated: true
    RegistrationId:
      type: object
      properties:
        modelId:
          type: string
    IdAndDisplayNameModel:
      type: object
      properties:
        id:
          type: string
        displayName:
          type: string
      description: 'DEPRECATED: not supported as of Jan 2026'
      readOnly: true
      deprecated: true
    ModelErrorDescription:
      type: object
      properties:
        customer_errors:
          type: array
          items:
            $ref: '#/components/schemas/CustomerError'
    Registration:
      required:
      - engineId
      - exportPeriod
      - intervalTime
      - intervalUnit
      type: object
      properties:
        commandLineParameters:
          type: array
          description: 'DEPRECATED: no longer supported as of Dec 2023'
          readOnly: true
          deprecated: true
          items:
            type: string
            description: 'DEPRECATED: no longer supported as of Dec 2023'
            readOnly: true
            deprecated: true
        commonFilter:
          type: string
          description: The filter to apply to the common event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: country=='United States'
        customEventFilter:
          type: string
          description: The filter to apply to the custom event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (customEventValue=='submitButton') AND (customEventType=='caseCreation')
        viewEventFilter:
          type: string
          description: The filter to apply to the view event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: viewContentType=@'product'
        engineId:
          type: string
          description: The id of the engine
          example: topclicks
        exportOffset:
          type: string
          description: The offset period to apply to the export. An undefined `exportOffset` means that the `exportPeriod` is based on the moment when the model was generated. An `exportOffset` of `P1W` means that the `exportPeriod` is based on the moment one week before the model was generated. If specified, must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1W
          deprecated: true
        exportPeriod:
          type: string
          description: The period to export data from. Unless an `exportOffset` is specified, the `exportPeriod` uses the moment when the model was generated as a base. Must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1D
        intervalTime:
          type: integer
          description: The number of `intervalUnit` between each run of the job, should be greater than or equal to 1
          format: int32
          example: 1
        extraConfig:
          type: object
          description: A JSON object representing the additional configuration to pass to a model configuration
          example:
            someKey: value
        intervalUnit:
          type: string
          description: The duration unit of the interval between each run of the job. See `intervalTime`
          example: WEEK
          enum:
          - DAY
          - WEEK
          - MONTH
        modelDisplayName:
          type: string
          description: The model display name in the Coveo Cloud V2 administration console
          example: MyModelDisplayName
        modelName:
          type: string
          description: The model name
          example: remove_me_model_name
        searchEventFilter:
          type: string
          description: The filter to apply to the click and search event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (originLevel1=~'search' OR originLevel1=~'listings')
        startTime:
          type: string
          description: 'DEPRECATED: no longer supported as of March 2026'
          format: date-time
          readOnly: true
          deprecated: true
        versionMatcher:
          $ref: '#/components/schemas/VersionExpression'
        groupsThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        apiKeysThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
      description: The registration's information
    ReadablePeriod:
      type: object
      properties:
        periodType:
          $ref: '#/components/schemas/PeriodType'
    VersionExpression:
      type: object
      description: 'DEPRECATED: no longer supported as of Dec 2025'
      readOnly: true
      deprecated: true
    OrgId:
      type: object
    Model:
      required:
      - engineId
      - exportPeriod
      - intervalTime
      - intervalUnit
      type: object
      properties:
        commandLineParameters:
          type: array
          description: 'DEPRECATED: no longer supported as of Dec 2023'
          readOnly: true
          deprecated: true
          items:
            type: string
            description: 'DEPRECATED: no longer supported as of Dec 2023'
            readOnly: true
            deprecated: true
        commonFilter:
          type: string
          description: The filter to apply to the common event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: country=='United States'
        customEventFilter:
          type: string
          description: The filter to apply to the custom event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (customEventValue=='submitButton') AND (customEventType=='caseCreation')
        viewEventFilter:
          type: string
          description: The filter to apply to the view event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: viewContentType=@'product'
        engineId:
          type: string
          description: The id of the engine
          example: topclicks
        exportOffset:
          type: string
          description: The offset period to apply to the export. An undefined `exportOffset` means that the `exportPeriod` is based on the moment when the model was generated. An `exportOffset` of `P1W` means that the `exportPeriod` is based on the moment one week before the model was generated. If specified, must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1W
          deprecated: true
        exportPeriod:
          type: string
          description: The period to export data from. Unless an `exportOffset` is specified, the `exportPeriod` uses the moment when the model was generated as a base. Must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1D
        intervalTime:
          type: integer
          description: The number of `intervalUnit` between each run of the job, should be greater than or equal to 1
          format: int32
          example: 1
        extraConfig:
          type: object
          description: A JSON object representing the additional configuration to pass to a model configuration
          example:
            someKey: value
        intervalUnit:
          type: string
          description: The duration unit of the interval between each run of the job. See `intervalTime`
          example: WEEK
          enum:
          - DAY
          - WEEK
          - MONTH
        modelDisplayName:
          type: string
          description: The model display name in the Coveo Cloud V2 administration console
          example: MyModelDisplayName
        modelName:
          type: string
          description: The model name
          example: remove_me_model_name
        searchEventFilter:
          type: string
          description: The filter to apply to the click and search event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (originLevel1=~'search' OR originLevel1=~'listings')
        startTime:
          type: string
          description: 'DEPRECATED: no longer supported as of March 2026'
          format: date-time
          readOnly: true
          deprecated: true
        versionMatcher:
          $ref: '#/components/schemas/VersionExpression'
        groupsThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        apiKeysThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        status:
          type: string
          enum:
          - COMPLETED
          - COMPLETED_DEGRADED
          - SCHEDULED
          - ERROR
          - IN_PROGRESS
          - ONLINE
          - ONLINE_DEGRADED
          - OFFLINE
          - IN_QUEUE
          - BUILDING
          - FAILED
          - IN_QUEUE_UPDATING
          - IN_PROGRESS_UPDATING
          - UPDATING
          - UPDATE_FAILED
        modelActivenessState:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - ARCHIVED
          - ARCHIVED_PENDING_REBUILD
        orgId:
          $ref: '#/components/schemas/OrgId'
        id:
          type: string
          description: The unique identifier of the target model
          example: My_Model_ID
        engineVersion:
          $ref: '#/components/schemas/EngineVersion'
        modelVersion:
          $ref: '#/components/schemas/ModelVersion'
        modelCreationTime:
          type: string
          description: The time when the model will be / was created
          format: date-time
        previousModelUpdateTime:
          type: string
          description: The moment when the model was last updated.
          format: date-time
        nextModelUpdateTime:
          type: string
          description: The next scheduled moment for starting the model update process.
          format: date-time
        platformVersion:
          type: integer
          format: int32
          deprecated: true
          enum:
          - 1
          - 2
        registrationKey:
          $ref: '#/components/schemas/RegistrationKey'
        modelSizeStatistic:
          type: integer
          description: The model size statistic. Depending on the model type, this value represents the number of items or queries on which the model was built.
          format: int32
          example: 1
        daysUntilArchival:
          type: integer
          format: int64
        modelErrorDescription:
          $ref: '#/components/schemas/ModelErrorDescription'
    Model_With_Additional_Information:
      required:
      - engineId
      - exportPeriod
      - intervalTime
      - intervalUnit
      type: object
      properties:
        commandLineParameters:
          type: array
          description: 'DEPRECATED: no longer supported as of Dec 2023'
          readOnly: true
          deprecated: true
          items:
            type: string
            description: 'DEPRECATED: no longer supported as of Dec 2023'
            readOnly: true
            deprecated: true
        commonFilter:
          type: string
          description: The filter to apply to the common event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: country=='United States'
        customEventFilter:
          type: string
          description: The filter to apply to the custom event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (customEventValue=='submitButton') AND (customEventType=='caseCreation')
        viewEventFilter:
          type: string
          description: The filter to apply to the view event dimensions (shared by all event types) in the export. Multiple filter parameters are joined with the AND operator
          example: viewContentType=@'product'
        engineId:
          type: string
          description: The id of the engine
          example: topclicks
        exportOffset:
          type: string
          description: The offset period to apply to the export. An undefined `exportOffset` means that the `exportPeriod` is based on the moment when the model was generated. An `exportOffset` of `P1W` means that the `exportPeriod` is based on the moment one week before the model was generated. If specified, must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1W
          deprecated: true
        exportPeriod:
          type: string
          description: The period to export data from. Unless an `exportOffset` is specified, the `exportPeriod` uses the moment when the model was generated as a base. Must be in the ISO8601 period format (i.e., `PyYmMwWdDThHmMsS`)
          example: P1D
        intervalTime:
          type: integer
          description: The number of `intervalUnit` between each run of the job, should be greater than or equal to 1
          format: int32
          example: 1
        extraConfig:
          type: object
          description: A JSON object representing the additional configuration to pass to a model configuration
          example:
            someKey: value
        intervalUnit:
          type: string
          description: The duration unit of the interval between each run of the job. See `intervalTime`
          example: WEEK
          enum:
          - DAY
          - WEEK
          - MONTH
        modelDisplayName:
          type: string
          description: The model display name in the Coveo Cloud V2 administration console
          example: MyModelDisplayName
        modelName:
          type: string
          description: The model name
          example: remove_me_model_name
        searchEventFilter:
          type: string
          description: The filter to apply to the click and search event dimensions in the export. Multiple filter parameters are joined with the AND operator
          example: (originLevel1=~'search' OR originLevel1=~'listings')
        startTime:
          type: string
          description: 'DEPRECATED: no longer supported as of March 2026'
          format: date-time
          readOnly: true
          deprecated: true
        versionMatcher:
          $ref: '#/components/schemas/VersionExpression'
        groupsThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        apiKeysThatCanEdit:
          uniqueItems: true
          type: array
          description: 'DEPRECATED: not supported as of Jan 2026'
          readOnly: true
          deprecated: true
          items:
            $ref: '#/components/schemas/IdAndDisplayNameModel'
        status:
          type: string
          enum:
          - COMPLETED
          - COMPLETED_DEGRADED
          - SCHEDULED
          - ERROR
          - IN_PROGRESS
          - ONLINE
          - ONLINE_DEGRADED
          - OFFLINE
          - IN_QUEUE
          - BUILDING
          - FAILED
          - IN_QUEUE_UPDATING
          - IN_PROGRESS_UPDATING
          - UPDATING
          - UPDATE_FAILED
        modelActivenessState:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - ARCHIVED
          - ARCHIVED_PENDING_REBUILD
        orgId:
          $ref: '#/components/schemas/OrgId'
        id:
          type: string
          description: The unique identifier of the target model
          example: My_Model_ID
        engineVersion:
          $ref: '#/components/schemas/EngineVersi

# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/coveo/refs/heads/main/openapi/coveo-machine-learning-models-api-openapi.yml