---
title: "List the supported Factory file schema versions"
method: GET
path: "/factory-files/schemas"
tags: ["Factories"]
---

# List the supported Factory file schema versions

`GET /factory-files/schemas`

## Request

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

Returns every Factory file schema version this server can describe,
with a link to each version's schema bundle.

## Headers

- `If-None-Match` string

## Response `200`

The supported schema versions

- FactoryFileSchemaRegistry: The Factory file schema versions a server can describe.
  - `current_version` string, required: The version a new Factory tree should declare.
  - `versions` FactoryFileSchemaVersionRef[], required: Every supported version, sorted by schema version.
    - `schema_version` string, required
    - `schema_url` string, required: Root-relative path of this version's schema bundle.

## Other responses

- `304`: The cached response is still current

## Changes

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

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/factory-files/schemas/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)