Errors

Error messages and HTTP statuses for Style guide API.

Error envelope

Errors use the standard HTTP API error format.

See HTTP API Overview.

Example:

{
  "error": true,
  "is_critical": 0,
  "message": "Failed to add rule. ...",
  "command": "style_guide"
}

Error Messages

Error responses include an action-specific prefix followed by the specific error.

Prefixes

Action	Prefix
addrule	Failed to add rule.
deleterule / deleterules	Failed to delete rule(s).
editrule	Failed to edit rule.
getrules	Failed to get rules.

addrule errors

Condition	Message	HTTP status
Rule already exists (same patterns + context_include)	Failed to add rule. Rule with pattern ["p1","p2"] and [no] include context already exists.	400
Missing required parameter	Failed to add rule. Required parameter '{param}' missing.	400
Parameter is empty	Failed to add rule. Parameter '{param}' can't be empty.	400
Forbidden characters	Failed to add rule. Forbidden characters found in '{param}'.	400
Length exceeded	Failed to add rule. Parameter '{param}' exceeds maximum length of {N} characters. Make it shorter and retry.	400
Too many rules (2000 limit)	Failed to add rule. Maximum of 2000 rules reached. Delete unused rules and retry.	400
Recursive suggestion	Failed to add rule. {Field} value can't be identical to or include the {other field} value.	400
Duplicate value within a parameter	Failed to add rule. Value '{val}' is repeated in '{param}' parameter.	400
Context value is substring of another	Failed to add rule. Parameter '{param}' contains a value that fully includes another. Consider keeping only the more specific one.	400

editrule errors

Condition	Message	HTTP status
Rule not found	Failed to edit rule. Rule not found. Use 'getrules' to check available rules.	404
Missing required parameter	Failed to edit rule. Required parameter '{param}' missing.	400
Parameter is empty	Failed to edit rule. Parameter '{param}' can't be empty.	400
Forbidden characters	Failed to edit rule. Forbidden characters found in '{param}'.	400
Length exceeded	Failed to edit rule. Parameter '{param}' exceeds maximum length of {N} characters. Make it shorter and retry.	400
Recursive suggestion	Failed to edit rule. {Field} value can't be identical to or include the {other field} value.	400
Duplicate value within a parameter	Failed to edit rule. Value '{val}' is repeated in '{param}' parameter.	400
No changes on edit	Failed to edit rule. No changes detected.	400
Context value is substring of another	Failed to edit rule. Parameter '{param}' contains a value that fully includes another. Consider keeping only the more specific one.	400

deleterule / deleterules errors

Condition	Message	HTTP status
Rule(s) not found	Failed to delete rule(s). Rule(s) not found. Use 'getrules' to check available rules.	404
Missing required parameter	Failed to delete rule(s). Required parameter '{param}' missing.	400
Parameter is empty	Failed to delete rule(s). Parameter '{param}' can't be empty.	400
Forbidden characters	Failed to delete rule(s). Forbidden characters found in '{param}'.	400
Length exceeded	Failed to delete rule(s). Parameter '{param}' exceeds maximum length of {N} characters. Make it shorter and retry.	400

getrules errors

Condition	Message	HTTP status
Rule not found	Failed to get rules. Rule not found. Use 'getrules' to check available rules.	404
Missing required parameter	Failed to get rules. Required parameter '{param}' missing.	400
Parameter is empty	Failed to get rules. Parameter '{param}' can't be empty.	400
Forbidden characters	Failed to get rules. Forbidden characters found in '{param}'.	400
Length exceeded	Failed to get rules. Parameter '{param}' exceeds maximum length of {N} characters. Make it shorter and retry.	400

Unknown action example

{
  "error": true,
  "is_critical": 0,
  "message": "Action not found. Available actions: addrule, deleterules, editrule, getrules.",
  "command": "style_guide"
}

Authorization error

An access key is required for this command. If it's not provided, you will see an error:

{
    "error": true,
    "message": "Access key is required to use 'style_guide' command."
}

See Access key.