Quiltt Logo

GraphQL

GraphQL is the primary interface for interacting with a specific user's data. If you're new to GraphQL, please review our How to use GraphQL guide.

GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools. - GraphQL

GraphQL API Reference

To access the full documentation and typings, explore the schema in the GraphQL API Reference or use the GraphQL Explorer in the Quiltt Dashboard.

Link to this section#What is GraphQL?

GraphQL is a modern and flexible API spec that allows the requesting client to design the response to suit their needs. Rather than having to page through many REST responses containing data that you don't need, you can craft a concise and specific request that is guaranteed to return only the details you do need.

A powerful feature of GraphQL is the ability to pack multiple queries and mutations into a single API call. Additionally, you can also batch requests using tools like Apollo Client, which will, for example, automatically roll up different requests from various components of your React.js app.

Link to this section#GraphQL Explorer

Our interactive GraphQL Explorer gives you access to all the queries and mutations your Quiltt environment supports. Additionally, it ships with an interactive query builder and typed schema explorer.

You can access the GraphQL Explorer in the Quiltt Dashboard

Link to this section#Queries

POSThttps://api.quiltt.io/v1/graphql

Queries allow you to get data related to a user, similar to GET requests in REST.

Link to this section#Mutations

POSThttps://api.quiltt.io/v1/graphql

Mutations allow you to modify data related to a user and return the following fields:

  • success to indicate whether the mutation was successful.
  • record to allow querying for nested fields on the subject of the mutation.
  • errors to help troubleshoot unsuccessful mutations.