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

# Validate a pipeline definition

> Validate a pipeline definition without deploying it. Returns validation errors and warnings.



## OpenAPI

````yaml /turbo-pipelines/api/openapi.json post /pipelines/validate
openapi: 3.1.0
info:
  title: Goldsky API
  description: >-
    REST API for managing Goldsky pipelines. Create, deploy, monitor, and manage
    data pipelines programmatically.


    For a full introduction to Turbo Pipelines, see the [Turbo Pipelines
    documentation](https://docs.goldsky.com/turbo-pipelines/introduction).
  version: 1.0.0
  contact:
    name: Goldsky Support
    email: support@goldsky.com
    url: https://docs.goldsky.com
servers:
  - url: https://api.goldsky.com/api/v1
    description: Goldsky API
security:
  - BearerAuth: []
tags:
  - name: Pipelines
    description: >-
      Create, read, update, and delete pipelines. Manage pipeline lifecycle
      (pause, resume, restart).
  - name: Pipeline Logs
    description: Retrieve pipeline execution logs.
  - name: Pipeline Status
    description: Query pipeline runtime status and state information.
paths:
  /pipelines/validate:
    post:
      tags:
        - Pipelines
      summary: Validate a pipeline definition
      description: >-
        Validate a pipeline definition without deploying it. Returns validation
        errors and warnings.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                definition:
                  type: object
                  properties:
                    sources:
                      type: object
                      additionalProperties: {}
                    transforms:
                      type: object
                      additionalProperties: {}
                    sinks:
                      type: object
                      additionalProperties: {}
                  required:
                    - sources
                    - transforms
                    - sinks
              required:
                - definition
            example:
              definition:
                sources:
                  my_source:
                    dataset_name: ethereum.raw_blocks
                    start_at: latest
                    type: dataset
                    version: 1.0.0
                transforms:
                  my_transform:
                    from: my_source
                    primary_key: id
                    type: handler
                    url: https://handler.com
                sinks:
                  my_sink:
                    from: my_transform
                    type: blackhole
                name: ethereum-blocks
                resource_size: s
                use_dedicated_ip: false
                job: false
                description: Streams Ethereum blocks
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - message
                  warnings:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - message
                required:
                  - valid
                  - errors
                  - warnings
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API token generated from the [Goldsky
        Dashboard](https://app.goldsky.com/dashboard/settings/project). Pass as:
        Authorization: Bearer <token>

````