overlay: 1.0.0
info:
  title: API Evangelist overlay for GMD API v3.0 Beta
  version: 1.0.0
extends: openapi/gracenote-gmd-api-v3-openapi.json
x-generated: '2026-09-12'
x-method: generated
x-source: openapi/_sources.yml
x-note: Additive only. This overlay records API Evangelist findings alongside the published contract;
  it never rewrites Gracenote content. The underlying spec in openapi/ is left exactly as fetched.
actions:
- target: $.info
  description: Record the production base URL API Evangelist confirmed from the Gracenote documentation,
    and the artifacts derived from this spec.
  update:
    x-apievangelist-production-base-url: https://api.gmd.music.gracenote.com/v3
    x-apievangelist-servers-note: servers[] in this document names a real production host.
    x-apievangelist-artifacts:
      authentication: authentication/gracenote-authentication.yml
      conventions: conventions/gracenote-conventions.yml
      errors: errors/gracenote-problem-types.yml
      rate_limits: rate-limits/gracenote-rate-limits.yml
      lifecycle: lifecycle/gracenote-lifecycle.yml
      data_model: data-model/gracenote-data-model.yml
      conformance: conformance/gracenote-conformance.yml
- target: $.info
  description: Record the gaps API Evangelist measured in this contract, without modifying the contract
    itself.
  update:
    x-apievangelist-gaps:
      operations: 13
      operations_missing_operationId: 13
      error_responses_declared:
      - '400'
      - '401'
      - '403'
      - '404'
      - '429'
      - '500'
      idempotency_key: false
      rate_limit_headers: false
      problem_json: false