---
title: "Create a validation file"
method: POST
path: "/validations"
tags: ["validations"]
---

# Create a validation file

`POST /validations`

## Request

- The document declares no server URL.
- Auth: none declared

Creates a new validation file at the specified path with optional initial cases. Returns the URI of the created file.

## Request body

- CreateValidationSetRequest: Request body for POST /validations endpoint.
  - `cases` ValidationCaseRequest[], required
    - `id` union
      - string
      - string[]
    - `labels` object, nullable
    - `predicate` string, nullable
    - `split` string, nullable
    - `target` unknown
    - `task_id` string, nullable
    - `task_repeat` integer, nullable
  - `path` string, required

## Response `200`

Successful Response

- string

## Changes

- **2026-05-24** `6482a1a81d1b`: 2 info
  - added the new optional request property `cases/items/task_id`
  - added the new optional request property `cases/items/task_repeat`
- **2026-04-03** `0fc41a5c1e02`: 1 breaking
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7` from the `cases/items/target/anyOf[#/components/schemas/JsonValue]/` request property `oneOf` list
- **2026-03-17** `d2a0b9f760ff`: 2 warning, 1 info
  - removed the request property `cases/items/task_id`
  - removed the request property `cases/items/task_repeat`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7` to the `cases/items/target/anyOf[#/components/schemas/JsonValue]/` request property `oneOf` list

[Operation history](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/changes/validations/post.md)

---

[API](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api.md) - [All operations](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/revisions/b799e9a81653?raw)