Check a Codex Tool Call
Checks a Codex PreToolUse hook. Extra input fields are accepted and ignored.
An allowed call returns {} so Codex follows its own approval settings.
A denied call returns a deny decision prefixed with NeMo Guardrails: .
An error status indicates a failed hook.
An allow is exactly {} and a deny has only the fields shown, because Codex treats an unknown field as a failed hook and runs the tool.
See Hooks Server Results and Errors
for error codes and the Retry-After: 30 header on a full queue.
Codex uses a command hook to send its input; use curl -f and || exit 2
so an error status blocks the call. See Check Codex Tool Calls with the Hooks Server.
Request
The event must be PreToolUse. Other events return 422 with unsupported_hook_event.
The tool name, matched exactly by the policy and per-tool rails. It must not be empty.