Documentation Index
Fetch the complete documentation index at: https://docs.utnor.com/llms.txt
Use this file to discover all available pages before exploring further.
Mistakes happen, and what matters is understanding what went wrong and what to do next. UTNOR returns client-side errors in a single, consistent JSON format across all tools, so failures are clear, predictable, and easy to handle.
Quick View (Canonical Template)
Use this template to understand the exact shape of the response. Values shown are placeholders only.
[
{
"tool": "TOOL_NAME",
"errors": [
{
"name": "ERROR_NAME",
"message": "Short reason for the error",
"reference": "https://docs.utnor.com/tools/TOOL_NAME/errors/ERROR_NAME",
"retriable": true,
"recoverable": false
}
],
"timestamp": "YYYY-MM-DDTHH:mm:ssZ",
"docs": "https://docs.utnor.com/",
"signature": "utnor"
}
]
Fields
All responses contain the fields below. Names and meanings are the same across all tools.
Top-Level Fields
| Field | Type | Nullable | Meaning |
|---|
tool | string | No | Tool that produced the error. |
errors | array | No | List of client-side errors. |
timestamp | string | No | ISO 8601 UTC timestamp when the request was received. |
docs | string | No | Link to UTNOR documentation. |
signature | string | No | Static identifier confirming UTNOR origin. |
Error Object Fields
| Field | Type | Nullable | Meaning |
|---|
name | string | No | Stable error name. |
message | string | No | Short explanation of the error. |
reference | string | Yes | Documentation link for the error. |
retriable | boolean | No | Retry without changes is allowed. |
recoverable | boolean | No | Input or state can be fixed and retried. |
Retry Behavior
Client behavior is determined by the combination of the following flags.
| retriable | recoverable | What to do |
|---|
| false | true | Fix input, then retry |
| true | false | Retry later |
| true | true | Retry or fix input |
| false | false | Do not retry |
- The response is always an array with a single object.
- Field names and meanings are stable across all tools.
- This format is used only for client-side errors.
