API Rate Limiting & Resilience

When this skill applies

Use this skill when building any integration that calls VTEX APIs — catalog sync, order processing, price/inventory updates, or fulfillment operations — and needs to handle rate limits gracefully without losing data or degrading performance.

• Implementing retry logic with exponential backoff and jitter
• Reading and reacting to VTEX rate limit headers (Retry-After, X-RateLimit-Remaining, X-RateLimit-Reset)
• Building circuit breakers for high-throughput integrations
• Controlling request throughput with queuing

Do not use this skill for:

• Catalog-specific synchronization logic (see marketplace-catalog-sync)
• Order event consumption and processing (see marketplace-order-hook)
• Invoice and tracking submission (see marketplace-fulfillment)

Decision rules