---
title: "Get the JSON Schema bundle for one Factory file schema version"
method: GET
path: "/factory-files/schemas/{schema_version}"
tags: ["Factories"]
---

# Get the JSON Schema bundle for one Factory file schema version

`GET /factory-files/schemas/{schema_version}`

## Request

- Base URL: `https://app.warp.dev/api/v1`
- URL: `https://app.warp.dev/api/v1/factory-files/schemas/{schema_version}`
- Auth: none required

Returns every JSON Schema 2020-12 document describing one Factory file
schema version, as a single bundle so the relative `$id` and `$ref`
identities between the documents keep resolving.

## Path parameters

- `schema_version` string, required

## Headers

- `If-None-Match` string

## Response `200`

The schema documents for this version

- FactoryFileSchemaBundle: Every JSON Schema document describing one Factory file schema version. The envelope is plain JSON; each value in `documents` is a JSON Schema 2020-12 document keyed by its `$id`.
  - `schema_version` string, required
  - `documents` object, required: Schema documents keyed by file name, which is also each document's $id.

## Other responses

- `304`: The cached response is still current
- `404`: The schema version is not supported by this server

## Changes

- **2026-10-13** `96d1e59a65c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/factory-files/schemas/:schema_version/get.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/warp/apis/oz-agent-api/revisions/4b5d145669be?raw)
