overlay: 1.0.0
info:
  title: Verta enrichment overlay for APISync
  version: 1.0.0
x-provenance:
  generated: '2026-07-21'
  method: generated
  source: API Evangelist enrichment pipeline; targets openapi/verta-APISync.swagger.json (verbatim grpc-gateway
    spec from github.com/VertaAI/modeldb)
extends: ../openapi/verta-APISync.swagger.json
actions:
- target: $.info
  description: Add human title, description, contact, and license absent from the generated grpc-gateway
    spec.
  update:
    title: Verta Deployment API Sync
    description: Verta ModelDB / Operational AI Platform REST API surface, generated by grpc-gateway from
      deployment/APISync.proto. Verta (verta.ai) was an MLOps model-management platform acquired by Cloudera
      on 2024-06-03; ModelDB remains open source under Apache-2.0 at github.com/VertaAI/modeldb. Served
      under basePath /v1; responses are application/json.
    contact:
      name: Verta / ModelDB (open source)
      url: https://github.com/VertaAI/modeldb
    license:
      name: Apache-2.0
      url: https://github.com/VertaAI/modeldb/blob/main/LICENSE
    x-api-evangelist-enriched: '2026-07-21'
- target: $
  description: Record cross-cutting Verta conventions as vendor extensions.
  update:
    x-verta-conventions:
      auth: email + developer key headers (VERTA_EMAIL / VERTA_DEV_KEY) or JWT (VERTA_JWT_TOKEN)
      pagination: page_number + page_limit request fields; total_records in responses
      error-envelope: grpc-gateway runtimeError { error, code, message, details[] } keyed to gRPC status
        codes
      base-path: /v1