API Evangelist enrichment overlay for Walmart Cost Management Assortment Recommendations Ship with Walmart API

overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay for Walmart Cost Management Assortment Recommendations Ship with Walmart API
  version: 1.0.0
extends: walmart-ship-with-walmart-api-openapi.yml
x-generated: '2026-08-27'
x-method: generated
x-source: rate-limits/walmart-rate-limits.yml, conventions/walmart-conventions.yml, errors/walmart-problem-types.yml
x-operations-matched: 7
actions:
- target: $.info
  description: Record API Evangelist provenance and the runtime facts Walmart documents outside the spec.
  update:
    x-apievangelist:
      profile: https://apis.io/provider/walmart/
      enriched: '2026-08-27'
      artifacts:
      - conventions/walmart-conventions.yml
      - errors/walmart-problem-types.yml
      - rate-limits/walmart-rate-limits.yml
      - lifecycle/walmart-lifecycle.yml
      - authentication/walmart-authentication.yml
- target: $
  description: Declare the cross-cutting runtime semantics Walmart documents on the portal but does not express in the contract.
  update:
    x-idempotency:
      supported: false
      note: No idempotency key mechanism is documented anywhere on developer.walmart.com.
    x-rate-limit-headers:
      remaining: x-current-token-count
      reset: X-Next-Replenishment-Time
      exhausted_status: 429
      oversized_payload_status: 413
    x-error-envelope:
      format: proprietary
      shape: '{"errors":[{"code","message","category","severity","field"}]}'
      rfc9457: false
    x-required-headers:
    - WM_SEC.ACCESS_TOKEN
    - WM_QOS.CORRELATION_ID
    - WM_SVC.NAME
    x-deprecation-policy: https://developer.walmart.com/us-marketplace/docs/walmart-marketplace-api-deprecation-guide
- target: $.paths['/v3/shipping/labels'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/shipping-estimates'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/purchase-orders/{purchaseOrderId}'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/carriers'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo}'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo}'].delete
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/shipping/labels/carriers/{carrierShortName}/package-types'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 100
      window: minute
      published: 100/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting