---
title: "Validate pipeline schema"
method: POST
path: "/pipelines/schema"
tags: ["Pipelines"]
---

# Validate pipeline schema

`POST /pipelines/schema`

Validate a pipeline definition without creating or updating a pipeline.

This endpoint does not require authentication. If you provide an API key, Orchestra also validates account-specific references such as integration connections. The endpoint is rate limited to 20 requests per minute per IP.

## Query parameters

- `canonicalize` boolean

## Request body

- object — Pipeline definition JSON to validate.

## Response `200`

Successful response.

- object
  - `message` string, required

## Other responses

- `429` — Too many requests. Wait before sending more requests.

---

[API](https://skmtc.net/getorchestra/apis/orchestra-api.md) · [All operations](https://skmtc.net/getorchestra/apis/orchestra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getorchestra/orchestra-api/versions/50f4d2ba114d/schema)