Schema Checks Reference

This reference describes the operations checks statuses you see in GraphOS Studio and the schema change types reported by the Rover CLI subgraph check response.

Operations check statuses

GraphOS classifies operations checks with the following statuses:

Types of schema changes

When you run a schema check, the check response classifies each schema change with the following codes.

Not every change to a schema is a potentially breaking change. Additive changes (such as adding a field to a type) are usually safe and do not affect active clients. Deletions and modifications (such as removing a field or changing a return type), however, can break clients that use affected types and fields.

If you use the GraphOS Router to report operation metrics, you can configure extended reference reporting for more accurate schema checks.

Potentially breaking changes

Removals

These changes remove a schema element. If an operation is actively using a removed element, that operation will start returning an error.

Addition of required arguments

These changes add a required input to a schema element. If an operation is actively using an element of your graph and doesn't add the new required input argument, the graph will return an error to affected clients.

In-place updates

These changes update an existing schema element. If an operation is actively using an element that is updated, the operation might start receiving an error from your graph. It also might receive an unexpected result.

Default values

These changes update the default value for an argument or input type. If an operation is using an element of your graph and does not specify a value for this argument, the operation might get an unexpected result when the schema is updated if it was relying on the original default value.

Non-breaking changes

These changes are detected by schema checks, but they are "safe." They never affect the behavior of any existing clients if deployed.

Schema additions

Deprecations

Descriptions