Skip to navigation

Check a NeMo Relay Tool Call

View as MarkdownOpen in Claude

Checks a NeMo Relay tool conditional-execution guardrail. Extra input fields return 422. An allow returns {"decision": "allow"}; a deny includes a reason without a prefix. The plugin maps these to Ok(None) and Ok(Some(reason)), and maps any error, timeout, or failed connection to Err.

See Hooks Server Results and Errors for error codes and the Retry-After: 30 header on a full queue.

See Check NeMo Relay Tool Calls with the NVIDIA NeMo Guardrails Plugin.

Request

This endpoint expects an object.
hook_event_name"NemoRelayToolConditionalExecutionGuardrail"Required

The event must be NemoRelayToolConditionalExecutionGuardrail. Other events return 422 with unsupported_hook_event.

tool_inputmap from strings to any or list of any or string or double or boolean or nullRequired
Tool call arguments. A value that is not a JSON object is denied.
tool_namestringRequired>=1 character

The tool name, matched exactly by the policy and per-tool rails. It must not be empty.

Response

Allow or deny decision
RelayAllowobject
OR
RelayDenyobject

Errors

422
Unprocessable Entity Error
500
Internal Server Error
503
Service Unavailable Error