Skip to main content
This error occurs when you attempt to connect a dataset to a connector, but the dataset’s schema is not compatible with the connector’s requirements.

Error response

{
  "type": "https://docs.narrative.io/reference/errors/dataset-schema-connector-incompatible",
  "title": "Dataset schema incompatible with connector",
  "status": 400,
  "detail": "The dataset schema is not compatible with the connector. <specific details about the incompatibility>",
  "instance": "/api/connectors",
  "logId": "unique-error-identifier"
}

Common causes

  • Missing required columns — The dataset is missing columns that the connector requires
  • Incompatible column types — A column exists but its data type does not match what the connector expects
  • Schema structure mismatch — The dataset’s overall schema structure does not align with the connector’s input requirements

How to resolve

  1. Check the detail field — It describes the specific incompatibility between your dataset schema and the connector
  2. Review connector requirements — Each connector expects a specific schema structure; verify your dataset matches
  3. Update your dataset schema — Modify the dataset to include the required columns with compatible data types
  4. Try a different connector — If the dataset cannot be modified, use a connector that supports the dataset’s schema

Error response fields

FieldDescription
typeLink to this documentation page
titleBrief description of the schema incompatibility
status400 — indicates a client request validation error
detailSpecific explanation of which columns or types are incompatible
instanceThe API endpoint that produced the error
logIdUnique identifier for support requests

Connectors

Reference for available connectors and their requirements

Datasets

Understand dataset schemas and structure

Error Reference

Overview of common API errors