API Evangelist overlay for StoreApi

overlay: 1.0.0
info:
  title: API Evangelist overlay for StoreApi
  version: 1.0.0
extends: openapi/caseys-general-stores-store-api-openapi.yml
x-generated: '2026-09-05'
x-method: derived
x-source: openapi/caseys-general-stores-store-api-openapi.yml + conventions/caseys-general-stores-conventions.yml
  + errors/caseys-general-stores-problem-types.yml + lifecycle/caseys-general-stores-lifecycle.yml
actions:
- target: $.info
  description: Record the provenance of this contract and the cross-cutting semantics API Evangelist measured
    across the estate.
  update:
    x-api-evangelist-source: https://developer.esl.caseys.io/mapi/apis/<apiId>?export=true&format=openapi+json&api-version=2022-08-01
    x-api-evangelist-harvested: '2026-09-05'
    x-gateway: Azure API Management, https://esl.caseys.io
    x-error-envelope-note: Errors are served as application/json, never application/problem+json. See
      errors/caseys-general-stores-problem-types.yml.
    x-rate-limit-note: No rate limit is documented and none is observable on live responses. See rate-limits/caseys-general-stores-rate-limits.yml.
- target: $.components.securitySchemes['apiKeyHeader']
  description: Say where the key comes from — the spec declares the header but not how to obtain a value
    for it.
  update:
    description: Azure API Management subscription key. Request one per API from the Casey's developer
      portal at https://developer.esl.caseys.io/ (sign-in required). Each API is fronted by its own APIM
      product, so a key for one API does not authorise another.
- target: $.paths['/brands'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/districts/{districtId}'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/districts'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/divisions/{divisionId}'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/divisions'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/store/{storeNumber}/organizational'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/regions/{regionId}'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/organizational/regions'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/store/{storeNumber}'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/store/{storeNumber}/hours'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/store/hours'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.
- target: $.paths['/store'].get
  description: Flag that the deprecation carries no retirement date.
  update:
    x-sunset: null
    x-deprecation-note: Marked deprecated by Casey's, but no Sunset or Deprecation header, no retirement
      date and no written deprecation policy is published. Treat the removal date as unknown.