Skip to Content
ErrorsSchemaOverview

Schema Deploy Errors

flexkit deploy compares your local schema with the deployed schema before applying an update. Compatibility checks prevent changes that could make existing data unreadable or unexpectedly remove fields used by Studio and GraphQL clients.

Types of Changes

Schema changes fall into three groups:

  • Safe changes, such as adding an entity or attribute, deploy normally.
  • Intentional breaking changes, such as removing an entity or attribute, are blocked until you acknowledge them with --allow-breaking-changes.
  • Unsafe changes, such as changing an existing attribute’s dataType, cannot be overridden. Migrate the data through a new attribute instead.

The --allow-breaking-changes option only acknowledges entity and attribute removals. It does not bypass invalid schema configuration, generated SDL errors, or unsafe data type changes.

Error Guides

Follow the guide linked by the CLI error before retrying the deployment.

Last updated on

© 2026