VTEX IO service paths and CDN behavior

When this skill applies

Use this skill when you define or change service.json routes for a VTEX IO backend and need the edge (CDN) to pass the right cookies and apply the right caching for that endpoint’s data.

• Choosing between public, segment (/_v/segment/...), and private (/_v/private/...) path prefixes for a route
• Setting Cache-Control (and related headers) on HTTP responses so public cache behavior matches data scope (anonymous vs segment vs authenticated shopper)
• Explaining why a route does not receive vtex_session or vtex_segment cookies
• Troubleshooting CloudFront or edge behavior when cookies are missing (see official troubleshooting)

Do not use this skill for:

• Application-level LRU caches, VBase, or stale-while-revalidate orchestration → use vtex-io-application-performance
• GraphQL field-level @cacheControl only → use vtex-io-graphql-api alongside this skill

Decision rules