vtex-io-service-paths-and-cdn

Configure VTEX IO service path prefixes and edge caching rules for Node or .NET backends.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtex/ai-skills --skill vtex-io-service-paths-and-cdn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vtex-io-service-paths-and-cdn
Source: https://github.com/vtex/ai-skills/tree/main/tracks/vtex-io/skills/vtex-io-service-paths-and-cdn
Command: npx skills add https://github.com/vtex/ai-skills --skill vtex-io-service-paths-and-cdn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Determine the correct configuration for VTEX IO service routes by selecting public, segment, or private path prefixes and applying edge caching controls to match data sensitivity and cookie visibility.

Core Features & Use Cases

  • Configure service.json routes to control what data is cached at the edge and which cookies are exposed to the client.
  • Align Cache-Control headers with data scope for public, segment, and private endpoints across Node or .NET IO backends.
  • Troubleshoot route prefix classification and edge behavior to ensure correct CDN interaction.

Quick Start

Provide a minimal, explicit configuration that maps a given route to the appropriate path prefix and caching policy.

Frequently Asked Questions about vtex-io-service-paths-and-cdn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure edge caching for VTEX IO service routes?

To configure edge caching for VTEX IO service routes, you define path prefixes and Cache-Control headers in your service.json file to match data sensitivity and determine CDN behavior. This aligns route classification with edge caching rules for Node or .NET backends, ensuring correct interaction.

What is the difference between public, segment, and private path prefixes in VTEX IO?

Public, segment, and private path prefixes in VTEX IO classify routes by data sensitivity and cookie visibility. Public prefixes allow broad edge caching, segment targets specific user data, and private restricts caching while exposing necessary cookies to the client browser.

How do I align Cache-Control headers with data scope for IO backends?

You align Cache-Control headers with data scope by selecting the correct path prefix in service.json. This configuration ensures that public, segment, or private endpoints across Node or .NET IO backends enforce the appropriate CDN caching constraints.

Can I use service.json to control cookie visibility for VTEX IO routes?

Yes, service.json configurations control cookie visibility by mapping routes to public, segment, or private path prefixes. This route classification determines which cookies are exposed to the client and how data is managed at the CDN edge.

Why does my VTEX IO CDN edge caching not work correctly for private routes?

VTEX IO CDN edge caching fails for private routes when path prefixes and Cache-Control headers are misaligned in service.json. Troubleshooting route prefix classification ensures that sensitive data is not cached at the edge and cookies remain correctly managed.

Do I need to classify all routes in service.json for Node and .NET IO backends?

Yes, you must classify all routes in service.json for Node and .NET IO backends. Applying public, segment, or private path prefixes is required to determine cookie visibility and enforce correct edge caching behavior for every endpoint.