Skip to content

Schema reference

Discover each Subgraph schema with introspection and use _meta for indexed block metadata.

Find the entities, fields, and filters you can query on a specific Subgraph. Every Subgraph has its own GraphQL schema, so GraphOps does not publish one universal entity reference. This page shows how to discover a schema and documents the _meta fields most Subgraphs share.

Discover the schema

Use GraphQL introspection, the schema published with the Subgraph project, or the schema map in Discover Subgraphs to discover:

  • Entity names.
  • Field names and scalar types.
  • Relationship fields.
  • Generated filters.
  • Generated ordering fields.
  • Whether full-text search fields are present.

Introspection query

query IntrospectionTypes {
  __schema {
    queryType {
      fields {
        name
      }
    }
    types {
      name
      kind
    }
  }
}

Use the same endpoint and authentication method as application queries.

Metadata reference

Most Subgraphs expose _meta:

FieldMeaning
_meta.deploymentDeployment serving the query.
_meta.block.numberLatest indexed block number available to the endpoint.
_meta.block.hashHash of the indexed block.
_meta.hasIndexingErrorsWhether indexing errors are present.
query Metadata {
  _meta {
    deployment
    block {
      number
      hash
    }
    hasIndexingErrors
  }
}

Historical queries

Do not rely on historical block queries

GraphOps Subgraphs are pruned. The service does not support historical GraphQL block queries as a production feature. Query the current indexed view and use _meta.block to understand freshness.

Generated client types

GraphOps does not provide service-level SDKs for Subgraphs. If your application needs generated types, generate them from the specific Subgraph schema using your GraphQL client toolchain.

Next steps