NetBird Full API Reference + Read-Only MCP Prototype
POST/api/agent-network/guardrails

Create an Agent Network Guardrail

Creates a new Agent Network guardrail that can be attached to one or more policies.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields

New guardrail request

checksobjectrequired
Guardrail check parameters. Each entry has an `enabled` flag plus per-check configuration; disabled entries are inert.
descriptionstringoptional
Optional human-readable description.
namestringrequired
Display name for the guardrail.

6 status codes
200Guardrail created
checksobjectrequired
Guardrail check parameters. Each entry has an `enabled` flag plus per-check configuration; disabled entries are inert.
created_atstringrequired
Timestamp when the guardrail was created.
descriptionstringrequired
Optional human-readable description.
idstringrequired
Guardrail ID
namestringrequired
Display name for the guardrail.
updated_atstringrequired
Timestamp when the guardrail was last updated.
400Bad Request
401Requires authentication
403Forbidden
409Conflict
messagestringoptional
A human-readable error message.
500Internal Server Error

Error handling

A 400 is returned: Bad Request. A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 409 is returned: Conflict. A 500 is returned: Internal Server Error.