vtex-io-http-routes

Implement HTTP endpoints for VTEX IO services with route handlers and middleware.

Updated May 8, 2026
One-click install
npx skills add https://github.com/Willjeanne/faststore-soliverdemo --skill vtex-io-http-routes-willjeanne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vtex-io-http-routes
Source: https://github.com/Willjeanne/faststore-soliverdemo/tree/main/.agents/skills/vtex-io-http-routes
Command: npx skills add https://github.com/Willjeanne/faststore-soliverdemo --skill vtex-io-http-routes-willjeanne

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit helps you design and implement explicit HTTP endpoints in a VTEX IO backend service, focusing on route boundaries, handler structure, middleware composition, request validation, and response modeling.

Core Features & Use Cases

  • HTTP Endpoint Implementation: Design HTTP endpoints using service.json routes and handlers.
  • Middleware Composition: Use middlewares for common concerns like validation and auth.
  • Request Validation: Ensure input validation and request normalization.
  • Response Modeling: Standardize response shape and status codes.
  • Use Case: Use this Skill to create a webhook endpoint for a partner integration or review existing VTEX IO handlers.

Quick Start

Use the vtex-io-http-routes skill to define a new route for a partner integration by adding a new route entry in the service.json file and implementing the corresponding handler in the node/routes directory.

Frequently Asked Questions about vtex-io-http-routes

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

FAQPage Schema
How do I implement HTTP endpoints in VTEX IO using service.json?

Middleware composition in VTEX IO allows you to handle common concerns like input validation and authentication before your main handler executes. Structuring handlers with middlewares ensures request normalization and standardizes response shape across your service routes.

What is the best way to validate requests and model responses for VTEX IO handlers?

The best way to validate requests and model responses is to design explicit HTTP contracts using middlewares for input validation and standardizing your response shape and status codes. This ensures predictable integration behavior within your VTEX IO backend service.

Can I use this approach to create a webhook endpoint for a partner integration?

Yes, you can create a webhook endpoint for a partner integration by adding a new route entry in the service.json file and implementing the corresponding handler in the node/routes directory. This provides explicit HTTP contracts for reliable partner integration behavior.

Do I need Node.js development knowledge to design VTEX IO HTTP routes?

Yes, you need knowledge of VTEX IO architecture and Node.js development to design HTTP routes. Implementing route boundaries, handler structure, and middleware composition requires understanding Node.js to ensure predictable integration behavior.