> ## 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.

# Validate a dataset schema

> Checks a dataset schema against what The Trade Desk audience connections accept, without creating anything.
Answers 200 with an empty body when the schema has at least one identifier the connector can deliver.



## OpenAPI

````yaml https://thetradedesk.narrativeconnectors.com/openapi.json post /validations/dataset-schema
openapi: 3.0.2
info:
  title: The Trade Desk Connector API
  version: '2026-10-22'
  description: >-
    The Trade Desk connector API.


    Every operation except `/interfaces`, `/validations/dataset-schema` and
    `/version` needs a Narrative API token in

    the `Authorization: Bearer <token>` header. A request without the header
    gets a 403 with an empty body.
servers:
  - url: https://thetradedesk.narrativeconnectors.com
    description: Production
  - url: https://thetradedesk-dev.narrativeconnectors.com
    description: Development
security:
  - smithy.api.httpBearerAuth: []
paths:
  /validations/dataset-schema:
    post:
      tags:
        - validations
      summary: Validate a dataset schema
      description: >-
        Checks a dataset schema against what The Trade Desk audience connections
        accept, without creating anything.

        Answers 200 with an empty body when the schema has at least one
        identifier the connector can deliver.
      operationId: ValidateDatasetSchema
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValidateDatasetSchemaRequest'
        required: true
      responses:
        '200':
          description: OK
        '400':
          description: >-
            - The request is invalid. `error` is `bad_payload` when the body or
            a parameter cannot be read, or `invalid_request` when the request is
            well-formed but cannot be applied.

            - The dataset schema has none of the identifiers the connector can
            deliver. `debug` is the JSON Schema validator's output, with one
            entry for each identifier the connector looked for.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/BadRequestError'
                  - $ref: '#/components/schemas/DatasetSchemaRejectedError'
        '500':
          description: Unexpected failure.
      security: []
components:
  schemas:
    ValidateDatasetSchemaRequest:
      type: object
      properties:
        id:
          type: integer
          description: Any number. The connector does not look the dataset up.
          format: int64
        schema:
          description: The dataset's JSON schema, as the Narrative API stores it.
      required:
        - id
        - schema
    BadRequestError:
      type: object
      description: >-
        The request is invalid. `error` is `bad_payload` when the body or a
        parameter cannot be read, or

        `invalid_request` when the request is well-formed but cannot be applied.
      properties:
        error:
          type: string
          description: '`bad_payload` or `invalid_request`.'
        error_description:
          type: string
      required:
        - error
        - error_description
    DatasetSchemaRejectedError:
      type: object
      description: >-
        The dataset schema has none of the identifiers the connector can
        deliver. `debug` is the JSON Schema

        validator's output, with one entry for each identifier the connector
        looked for.
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
          format: int32
        detail:
          type: string
        instance:
          type: string
        debug:
          description: The validator's output.
      required:
        - debug
        - detail
        - instance
        - status
        - title
        - type
  securitySchemes:
    smithy.api.httpBearerAuth:
      type: http
      description: HTTP Bearer authentication
      scheme: Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.