Hooks Server API Overview
The Guardrails hooks server (nemoguardrails hooks-server) checks coding agents’ tool calls before they run.
It is a separate server from the Guardrails API Server, with its own endpoints.
For running it and connecting agents, refer to Use the Guardrails Hooks Server.
Base URL
The default base URL is:
The server listens on 127.0.0.1:8100 by default. Set --host and --port to change it.
Authentication
The hooks server has no authentication.
Keep it on 127.0.0.1, or on a private network that restricts who can reach the port.
Endpoints
The server exposes the following endpoints:
Every other path returns 404, and the server serves no OpenAPI document or docs pages.
Each hook endpoint applies the same configuration: the path selects only the agent’s request and response format.
The server reads the request body as JSON whatever its Content-Type header says.
Outcomes
A hook endpoint answers each check with one of three outcomes:
For error codes and when they occur, refer to Hooks Server Results and Errors.