Root Types

GraphQL queries begin from root types: query, mutation, and subscription (experimental).

Attach these to your schema using methods with the same name:

class MySchema < GraphQL::Schema
  # required
  query Types::QueryType
  # optional
  mutation Types::MutationType
  # experimental
  subscription Types::SubscriptionType
end

The types are GraphQL::Schema::Object classes, for example:

# app/graphql/types/query_type.rb
class Types::QueryType < GraphQL::Schema::Object
  # ...
end

# Similarly:
class Types::MutationType < GraphQL::Schema::Object
  # ...
end
# and
class Types::SubscriptionType < GraphQL::Schema::Object
  # ...
end

Each type is the entry point for the corresponding GraphQL query:

query GetPost {
  # `Query.post`
  post(id: 1) { ... }
}

mutation AddPost($postAttrs: PostInput!){
  # `Mutation.createPost`
  createPost(attrs: $postAttrs)
}

# Experimental
subscription CommentAdded {
  # `Subscription.commentAdded`
  commentAdded(postId: 1)
}