overlay: 1.0.0
info:
  title: API Evangelist enhancements for Sovrn Commerce Product Promo Codes API
  version: 1.0.0
extends: openapi/sovrn-product-coupons-openapi.yml
actions:
- target: $.info
  description: Record API Evangelist provenance and the runtime facts Sovrn documents in prose but not
    in the spec.
  update:
    x-apievangelist-source: https://developer.sovrn.com/
    x-apievangelist-harvested: '2026-08-12'
    x-apievangelist-note: OpenAPI harvested verbatim from the definition Sovrn embeds in its own developer-center
      reference pages. Operations sharing this info/servers block were merged into one document; operation
      content is unmodified.
    x-authentication: Commerce Secret Key header, plus `api_key` query parameter
    x-authentication-artifact: authentication/sovrn-authentication.yml
    x-conventions-artifact: conventions/sovrn-conventions.yml
    x-error-catalog-artifact: errors/sovrn-problem-types.yml
- target: $.tags
  description: Declare a tag for this service; Sovrn's published definitions carry no tags at all.
  update:
  - name: promo-codes
    description: Sovrn Commerce Product Promo Codes API operations.
- target: $.paths.*.*
  description: Tag every operation so the estate can be grouped; no operation in Sovrn's published definitions
    is tagged.
  update:
    tags:
    - promo-codes