Client Integration & Service Access

When this skill applies

Use this skill when the main decision is how a VTEX IO backend app should call VTEX services or external APIs through the VTEX IO client system.

• Creating custom clients under node/clients/
• Choosing between native clients from @vtex/api or @vtex/clients and a custom client
• Registering clients in IOClients and exposing them through ctx.clients
• Configuring InstanceOptions such as retries, timeout, headers, or caching
• Reviewing backend integrations that currently use raw HTTP libraries

Do not use this skill for:

• deciding the app contract in manifest.json
• structuring node/index.ts or tuning service.json
• designing GraphQL schema or resolver contracts
• modeling route authorization or security permissions
• building storefront or admin frontend integrations