---
title: "Set (or clear) the Spec rail"
method: PUT
path: "/v1/schemas/{id}/rail"
tags: ["Schemas"]
---

# Set (or clear) the Spec rail

`PUT /v1/schemas/{id}/rail`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/schemas/{id}/rail`
- Auth: HTTP bearer

Replaces the rail. An empty `rail` array clears it. Requires the `write` scope.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `rail` object[], required
    - `type` 'source' | 'registry' | 'schema' | 'resolve' | 'valid' | 'assembly' | 'deliver' | 'dispatch' | 'reconcile' | 'sanitize' | 'triage', required
    - `name` string
    - `sub` string
    - `json` object

## Response `200`

Rail saved

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)