How the JSON to GraphQL Converter Works

GraphQL schemas define the contract between your API and its clients. Writing them by hand is error-prone and time-consuming. This converter generates everything you need from sample data.

What Gets Generated

• Object types for your data structures
• Input types for mutations
• Query type with get, list, and count operations
• Mutation type with create, update, delete, and bulk operations
• Example mutations pre-filled with your actual data

Type Mapping

GraphQL has its own scalar types. The converter maps JSON values intelligently, including special handling for ID fields.

Generated Queries

The Query type includes standard CRUD read operations with pagination support.

type Query {
  getUser(id: ID!): User
  listUsers(limit: Int, offset: Int): [User!]!
  countUsers: Int!
}

Generated Mutations

The Mutation type includes create, update, delete, and bulk create operations using generated input types.

type Mutation {
  createUser(input: UserInput!): User!
  updateUser(id: ID!, input: UserInput!): User
  deleteUser(id: ID!): Boolean!
  bulkCreateUsers(inputs: [UserInput!]!): [User!]!
}

Input Types

For every object type, a corresponding input type is generated. Input types use the same structure but are named with an 'Input' suffix.

type User {
  id: ID
  name: String
  email: String
}

input UserInput {
  id: ID
  name: String
  email: String
}

Example Mutations

The converter generates example mutation operations pre-filled with your actual JSON data. These serve as templates and documentation.

# Create single User
mutation CreateUser {
  createUser(input: {
    name: "John Doe"
    email: "john@example.com"
  }) {
    id
  }
}

Bulk Operations

If your JSON is an array with multiple objects, the converter generates a bulk create mutation example with up to 5 items from your data.