---
title: "Get one Factory file schema document"
method: GET
path: "/factory-files/schemas/{schema_version}/{document}"
tags: ["Factories"]
---

# Get one Factory file schema document

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

## Request

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

Returns a single generated JSON Schema document on its own, rather
than inside the bundle envelope, so it can be used directly as a
schema reference. A document served here resolves its relative
`$ref`s against its siblings at this same path, which is what each
document's `$id` assumes, making the URL usable directly from an
editor or YAML language server, for example:

```yaml
# yaml-language-server: $schema=/api/v1/factory-files/schemas/v1alpha1/factory.schema.json
```

## Path parameters

- `schema_version` string, required
- `document` string, required

## Response `200`

The requested JSON Schema document

- object

## Other responses

- `404`: The version or the document is unknown

## 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/:document/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)