> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dataset Schema Incompatible with Connector

> Resolve HTTP 400 schema validation failures when connecting datasets to connectors

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. Compatibility is decided by the target [connector interface](/concepts/data-activation/connector-interfaces)'s collaboration policy — the rules that determine which dataset schemas the interface accepts.

## Error response

```json theme={null}
{
  "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

| Field      | Description                                                     |
| ---------- | --------------------------------------------------------------- |
| `type`     | Link to this documentation page                                 |
| `title`    | Brief description of the schema incompatibility                 |
| `status`   | `400` — indicates a client request validation error             |
| `detail`   | Specific explanation of which columns or types are incompatible |
| `instance` | The API endpoint that produced the error                        |
| `logId`    | Unique identifier for support requests                          |

## Related content

<CardGroup cols={2}>
  <Card title="Connectors" icon="plug" href="/reference/connectors/index">
    Reference for available connectors and their requirements
  </Card>

  <Card title="Connector Interfaces" icon="plug-circle-bolt" href="/concepts/data-activation/connector-interfaces">
    How an interface's collaboration policy decides schema compatibility
  </Card>

  <Card title="Datasets" icon="database" href="/concepts/primitives/datasets">
    Understand dataset schemas and structure
  </Card>

  <Card title="Error Reference" icon="triangle-exclamation" href="/reference/errors/index">
    Overview of common API errors
  </Card>
</CardGroup>