vtex-io-events-and-workers

Configure idempotent events and workers in VTEX IO service.json files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apply when designing or implementing asynchronous processing in VTEX IO services through events, workers, and background handlers. Covers event handler structure, idempotency, retry-safe processing, and moving expensive work out of request-response routes. Use for event-driven integrations, delayed processing, or background jobs in VTEX IO apps.

Core Features & Use Cases

  • Idempotent event handlers and workers to tolerate duplicate deliveries
  • Explicitly declare events and workers in service.json to wire runtime behavior
  • Move heavy or delayed work out of HTTP routes to improve request-response latency and reliability

Quick Start

Create an event-driven VTEX IO app that uses idempotent event handlers and a background worker to process long-running tasks.

Frequently Asked Questions about vtex-io-events-and-workers

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

FAQPage Schema
How do I handle asynchronous background processing in VTEX IO without blocking HTTP routes?

To handle asynchronous background processing in VTEX IO, move heavy or delayed work out of request-response routes by declaring events and workers in service.json, which improves route latency and reliability.

What is the best way to ensure idempotent event handlers in VTEX IO apps?

The best way to ensure idempotent event handlers in VTEX IO apps is to design retry-safe processing logic with explicit input contracts and durable state storage, tolerating duplicate event deliveries without side effects.

How do I declare events and workers in service.json for VTEX IO event-driven integrations?

To declare events and workers in service.json for VTEX IO integrations, explicitly define the event handlers and background workers configuration to wire the runtime behavior for delayed or batched tasks within IO services.

Can I use VTEX IO workers for delayed or batched background tasks?

Yes, you can use VTEX IO workers for delayed or batched background tasks by configuring them within service.json to execute event-driven integrations asynchronously, moving expensive operations out of synchronous routes.

Why do my VTEX IO event handlers fail on duplicate event deliveries?

VTEX IO event handlers fail on duplicate deliveries if they lack idempotency. You must implement retry-safe processing with explicit input contracts and durable state storage to safely tolerate duplicate background worker events.