API Reference
Update Schema
Update a schema's configuration via API Key — without going through the dashboard. Useful for automation pipelines that need to adjust prompts, definitions, or memory settings programmatically.
PATCH/api/schemas/:id
Partially updates a schema. Only the fields you send are changed — omitted fields remain untouched. The Railway backend creates a new schema version automatically on every update.
Authentication
http
PATCH /api/schemas/:id
X-Reliant-Key: rel_your_api_key
Content-Type: application/json
Allowed fields
| Field | Type | Description |
|---|---|---|
| name | string | Human-readable schema name. |
| definition | object | JSON Schema defining the expected LLM output structure. |
| system_prompt | string | Custom system prompt for this schema. |
| safe_fallback | object | Value returned when all providers fail. |
| memory_enabled | boolean | Enable per-end-user conversation memory. |
| memory_window | number | Number of prior turns included in context (default: 10). |
| fallback_providers | string[] | Ordered fallback provider list. |
| quality_criteria | string | Natural-language criteria for the LLM quality judge. |
Example
json — body
{
"system_prompt": "Extract only confirmed contacts. Ignore incomplete entries.",
"memory_enabled": true,
"memory_window": 20
}
json — 200 OK
{
"id": "sch_...",
"name": "Contact Extraction",
"version": 3,
"system_prompt": "Extract only confirmed contacts. Ignore incomplete entries.",
"memory_enabled": true,
"memory_window": 20,
"updated_at": "2026-08-05T03:00:00Z"
}
Error responses
| Status | Cause |
|---|---|
400 | No recognized field was sent in the body. |
401 | Missing or invalid X-Reliant-Key. |
404 | Schema ID not found. |