HTTP Routes & Handler Boundaries

When this skill applies

Use this skill when a VTEX IO service needs to expose explicit HTTP endpoints through service.json routes and implement the corresponding handlers under node/.

• Building callback or webhook endpoints
• Exposing integration endpoints for partners or backoffice flows
• Structuring route handlers and middleware chains
• Validating params, query strings, headers, or request bodies
• Standardizing response shape and status code behavior

Do not use this skill for:

• sizing or tuning the service runtime
• deciding app policies in manifest.json
• designing GraphQL APIs
• modeling async event or worker flows

Decision rules