List all policies | NetBird Full API Reference + Read-Only MCP Prototype

5 status codes

200Returns an array of policy objects, including each policy's name, enabled state, rules, and source posture checks.

descriptionstringoptional

Policy friendly description

enabledbooleanrequired

Policy status

namestringrequired

Policy name identifier

idstringoptional

Policy ID

rulesarray<object>required

Policy rule object for policy UI editor

source_posture_checksarray<string>required

Posture checks ID's applied to policy source groups

400Returned when the request is invalid.

401Returned when authentication is missing or invalid.

403Returned when the authenticated user is not permitted to access policies.

500Returned when an internal server error occurs.

Error handling

A 400 is returned when the request is invalid; a 401 is returned when authentication is missing or invalid; a 403 is returned when the authenticated user is not permitted to access policies; and a 500 is returned when an internal server error occurs.

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.policies.list();

[
  {
    "description": "This is a default policy that allows connections between all the resources",
    "enabled": true,
    "name": "ch8i4ug6lnn4g9hqv7mg",
    "id": "ch8i4ug6lnn4g9hqv7mg",
    "rules": [
      {
        "action": "accept",
        "bidirectional": true,
        "description": "This is a default rule that allows connections between all the resources",
        "enabled": true,
        "name": "Default",
        "port_ranges": [
          null
        ],
        "ports": [
          null
        ],
        "protocol": "tcp",
        "destinationResource": "example_value",
        "destinations": [
          null
        ],
        "id": "ch8i4ug6lnn4g9hqv7mg",
        "sourceResource": "example_value",
        "sources": [
          null
        ]
      }
    ],
    "source_posture_checks": [
      "chacdk86lnnboviihd70"
    ]
  }
]

Response

Errors