Skip to content

Developers · GraphQL

Common GraphQL Types Overview

Last updated 1 November 2026

The kinds of shared GraphQL type on Insites, how many of each there are, and how to look one up.

The common types are the building blocks every Insites GraphQL query and mutation uses. When a query takes a filter or returns a RecordCollection, the shape of that argument or result is a common type. This section lists them by kind.

Use these pages when you write a query by hand. They tell you which fields a type has, which values an enum allows and which operators a filter accepts.

The kinds of type

KindOn the docs instanceWhat it is
Objects135Results you select fields from, such as Record
Inputs230Arguments you pass, such as RecordsFilterInput
Enums41A fixed list of values, such as ASC and DESC
Scalars22Single values, such as String and ID
Interfaces16Fields that several objects share
Unions1A field that can return one of several objects
Directives6Instructions such as @include and @skip

The counts come from introspection of the docs.insites.io instance on 1 November 2026. Every instance has the same schema, but deprecated fields are left out of introspection, so the counts are a guide rather than a contract.

The queries and mutations pages list the root operations themselves.

Example: look up a type yourself

Any type can be read from the instance with an introspection query. This is the fastest way to check a type while you write code:

Query

{
  __type(name: "Customizable") {
    kind
    name
    possibleTypes { name }
  }
}

Response on the docs instance

{
  "data": {
    "__type": {
      "kind": "UNION",
      "name": "Customizable",
      "possibleTypes": [
        { "name": "Listing" },
        { "name": "Profile" },
        { "name": "User" }
      ]
    }
  }
}

Common mistakes

  • Passing an object type where an input is expected. Arguments always take input types.
  • Writing an enum value as a string. Write order: ASC, not order: "ASC".
  • Assuming a field is missing because introspection does not list it. Deprecated fields are hidden there but may still run.