---
title: "Validate Blueprint"
method: POST
path: "/blueprints/validate"
tags: ["Blueprints"]
---

# Validate Blueprint

`POST /blueprints/validate`

Validate a `render.yaml` Blueprint file without creating or modifying any resources. This endpoint checks the syntax and structure of the Blueprint, validates that all required fields are present, and returns a plan indicating the resources that would be created.

Requests to this endpoint use `Content-Type: multipart/form-data`. The provided Blueprint file cannot exceed 10MB in size.

## Response `200`

Validation complete

- object
  - `valid` boolean, required — If `true`, the Blueprint validated successfully. If `false`, at least one validation error occurred.
  - `errors` object[] — A list of validation errors. Only present if `valid` is `false`.
    - `path` string — The path to the field with the error (e.g., `services[0].plan`)
    - `error` string, required — The error message
    - `line` integer — The line number in the YAML file (1-indexed)
    - `column` integer — The column number in the YAML file (1-indexed)
  - `plan` object — A summary of the resources that would be created as part of the Blueprint. Only present if `valid` is `true`.
    - `services` string[] — The names of services that would be created as part of the Blueprint.
    - `databases` string[] — The names of Render Postgres databases that would be created as part of the Blueprint.
    - `keyValue` string[] — The names of Render Key Value instances that would be created as part of the Blueprint.
    - `envGroups` string[] — The names of environment groups that would be created as part of the Blueprint.
    - `totalActions` integer — The total number of actions that would be performed by the Blueprint. In addition to created resources, this includes modifications to individual configuration fields.

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `403` — You do not have permissions for the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)