Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
Functional AppsMessages
Messages GraphQL API
vtex.messages
Version: 1.69.2
Latest version: 1.69.2

This article serves as a comprehensive reference for the GraphQL API provided by the Messages app. This API enables the internationalization of messages in various store contexts, such as Catalog, Intelligent Search, and VTEX IO apps. For more details about how this API is used, see the Overwriting the Messages app article.

Schema overview

Query

classDiagram
  direction LR
  class Languages {
    supported [String!]!
    default String!
  }

  class Translation {
    lang String!
    translation String!
  }

  class MessageListV2 {
    srcLang String!
    groupContext String
    context String
    translations [Translation!]!
  }

  class Query {
    languages Languages!
    translate(args TranslateArgs!) [String]!
    translateWithDependencies(args TranslateWithDependenciesArgs!) [String]!
    userTranslations(args IndexedMessages!) [MessageListV2]!
    listV2(args ListArgsV2!) [MessageListV2!]!
    authorize Boolean!
  }

  Query --> Languages : languages
  MessageListV2 --> Translation : translations
  Query --> MessageListV2 : userTranslations
  Query --> MessageListV2 : listV2

  click Query href "#query"
  click Languages href "#languages"
  click MessageListV2 href "#messagelistv2"
  click Translation href "#translation"

Mutation

classDiagram
  direction LR
  class Mutation {
    saveV2(args SaveArgsV2!) Boolean!
  }

  click Mutation href "#mutation"

Schema description

Arguments must be provided by the user. Required fields are marked with an exclamation mark (!).

Languages

MessageListV2

Translation

IndexedMessages

ListArgsV2

MessageInputV2

MessageSaveInputV2

MessagesRange

SaveArgsV2

TranslateArgs

TranslateWithDependenciesArgs

Behavior

Encoding

See also
Vtex.messages
VTEX IO Apps
VTEX App Store
VTEX IO Apps