overlay: 1.0.0
info:
  title: API Evangelist enhancements for Sovrn Commerce Product Recommendation API
  version: 1.0.0
extends: openapi/sovrn-product-recommendations-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: '`apiKey` 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: $.info
  description: Attach the published rate limit, which Sovrn documents on the reference page rather than
    in the spec.
  update:
    x-rate-limit: 30,000 requests per 5 minutes per key; 100 requests per 5 minutes per IP
    x-rate-limit-docs: https://developer.sovrn.com/reference/get_product_recommendations
    x-rate-limit-artifact: rate-limits/sovrn-rate-limits.yml
- target: $.tags
  description: Declare a tag for this service; Sovrn's published definitions carry no tags at all.
  update:
  - name: products
    description: Sovrn Commerce Product Recommendation 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:
    - products