Verta · OpenAPI Overlay 1.0.0

Verta enrichment overlay for Authorization

2 actions 2 updates documentation extends ../openapi/verta-Authorization.swagger.json

Generated by API Evangelist Written by API Evangelist tooling for Verta's API. It is a proposal applied on top of the contract, not a document Verta publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

titledescriptioncontactlicensex-api-evangelist-enrichedx-verta-conventions

Targets 2

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: Verta enrichment overlay for Authorization
  version: 1.0.0
x-provenance:
  generated: '2026-07-21'
  method: generated
  source: API Evangelist enrichment pipeline; targets openapi/verta-Authorization.swagger.json (verbatim
    grpc-gateway spec from github.com/VertaAI/modeldb)
extends: ../openapi/verta-Authorization.swagger.json
actions:
- target: $.info
  description: Add human title, description, contact, and license absent from the generated grpc-gateway
    spec.
  update:
    title: Verta Authorization (Authz) Service
    description: Verta ModelDB / Operational AI Platform REST API surface, generated by grpc-gateway from
      uac/Authorization.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