x-api-key header and JSON in the request body.
SILMARIL_API_URL is your complete classify URL. It already includes /classify and any deployment path prefix. Get both environment values through deployment access.
The HTTP examples use standard libraries: Node.js 20 or later, Python 3.10 or later, Go 1.22 or later, or Java 17 or later. Each prints the response body; inspect its verdict before consuming the event.
Keep the key in your service
Make API calls from the service that owns model inference, tool execution, or orchestration. Store the key in that service’s environment or secret manager. Keep it out of browser bundles and source control.Authentication errors
The direct Firewall runtime returns401 when the API key is missing, 403 when the key is invalid or the request’s traffic class or forced surface is unauthorized, and 503 when authentication policy is unavailable. Hosted gateways can return 403 for either a missing or invalid key, so these status distinctions are not universal across every deployment path.
Check that the key belongs to the deployment you are calling. Authentication error bodies can differ between hosted gateways and self-hosted runtimes. they do not contain a classification verdict.