vtex-io-graphql-api

To build a GraphQL API in a VTEX IO app, place your schema in the graphql/ directory, implement resolvers under node/resolvers/, declare the graphql builder in manifest.json, and wire everything into the Service entry point.

You add authentication and caching to VTEX IO GraphQL resolvers by applying the @auth and @cacheControl directives directly on appropriate fields within your schema definitions.

VTEX IO GraphQL resolvers fail when resolver names do not match schema fields or the graphql builder is missing from manifest.json. Ensure resolver names align with schema fields and the builder is declared.

You need to declare the graphql builder in VTEX IO whenever your app requires a combined schema and resolver wiring to expose queries and mutations through a Service entry point.

The best way to expose data safely through a VTEX IO GraphQL API is by implementing data access via ctx.clients combined with proper authentication and caching directives on your schema fields.