Error Codes
All Nolma errors follow this format:NM_UNAUTHORIZED (401)
Missing or invalidNM-Key header.
NM-Key header value. Keys start with nm_live_ or nm_test_.
API Reference
Error Codes
All Nolma error types and how to handle them
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
All Nolma error types and how to handle them
{
"error": {
"type": "NM_ERROR_TYPE",
"code": "NM_ERROR_TYPE",
"message": "Human readable message"
}
}
NM-Key header.
{
"error": {
"type": "NM_UNAUTHORIZED",
"message": "Invalid or missing NM-Key header."
}
}
NM-Key header value. Keys start with nm_live_ or nm_test_.
{
"error": {
"type": "NM_BUDGET_HARD_LIMIT",
"message": "Agent 'support-bot' daily budget of $15.00 exceeded.",
"spent": 15.43,
"limit": 15.00,
"period": "daily",
"reset_at": "2026-05-22T00:00:00Z",
"agent": "support-bot",
"session_id": "sess_8f3a2c19"
}
}
{
"error": {
"type": "NM_SHIELD_BLOCKED",
"message": "Request blocked by Nolma Shield.",
"risk_score": 0.94,
"threat_type": "INJECTION",
"session_id": "sess_8f3a2c19"
}
}
{
"error": {
"type": "NM_PAYMENT_REQUIRED",
"message": "Shadow mode requires Pro plan."
}
}
{
"error": {
"type": "NM_RETRY_LOOP_DETECTED",
"message": "Retry loop detected. Blocked for 5 minutes.",
"resume_at": "2026-05-22T10:35:00Z",
"agent": "support-bot"
}
}
{
"error": {
"type": "NM_PII_DETECTED",
"message": "PII detected in request. Block mode is enabled."
}
}