API Evangelist overlay for Gloo Platform Portal API

overlay: 1.0.0
info:
  title: API Evangelist overlay for Gloo Platform Portal API
  version: 1.0.0
extends: ../openapi/gloo-platform-portal-openapi.yaml
x-provenance:
  generated: '2026-09-12'
  method: generated
  source: openapi/gloo-platform-portal-openapi.yaml
  note: 'Non-destructive. The original contract is never mutated; this overlay records only API Evangelist
    enhancements. Operation-level tagging is deliberately NOT added: all operations in these contracts
    are already tagged.'
actions:
- target: $.info
  description: 'Record API Evangelist provenance: where this contract was harvested from and when.'
  update:
    x-apievangelist:
      harvested: '2026-09-12'
      source: https://github.com/solo-io/gloo-mesh-use-cases/blob/main/gloo-gateway/portal/openapi.yaml
      provider: gloo
      method: searched
- target: $.info
  description: Add Solo.io's published support contact; the original contract declares none.
  update:
    contact:
      name: Solo.io
      url: https://www.solo.io/company/get-support
- target: $
  description: Record what the servers[] block actually means for a client, so a published host is not
    mistaken for a callable one.
  update:
    x-deployment-note: servers[] is https://api.gloo-platform-portal.com/v1, a host that does not resolve
      (probed 2026-09-12, connection failure). It is illustrative documentation, not a live endpoint.
- target: $
  description: Declare at document level the 2 tags the operations already use. Every operation in this
    contract is tagged, but the document declares no tags[] block, so tooling has no descriptions to render.
  update:
    tags:
    - name: User
    - name: APIs