List all Agent Network Guardrails | NetBird Full API Reference + Read-Only MCP Prototype

4 status codes

200A JSON Array of Agent Network guardrails

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.

401Requires authentication

403Forbidden

500Internal Server Error

Error handling

A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 500 is returned: Internal Server Error.

import { NetBirdManagementAPIUnofficialOctriFullPreview } from "netbird-management-api-|-unofficial-octri-full-preview";

const client = new NetBirdManagementAPIUnofficialOctriFullPreview({
  baseUrl: "https://api.netbird.io",
  auth: { bearerAuth: process.env.API_TOKEN! },
});

const result = await client.agentNetwork.listGuardrails();

[
  {
    "checks": {
      "model_allowlist": {
        "enabled": true,
        "models": [
          "gpt-4o-mini",
          "claude-haiku-4-5"
        ]
      },
      "prompt_capture": {
        "enabled": true,
        "redact_pii": true
      }
    },
    "created_at": "2026-04-26T10:30:00Z",
    "description": "Tight model allowlist, PII redaction, hard monthly budget.",
    "id": "ainguard_d1m3kebd9pcs0c1pnu7g",
    "name": "Strict — Production",
    "updated_at": "2026-04-26T10:30:00Z"
  }
]

Response

Errors