NetBird Full API Reference + Read-Only MCP Prototype
GET/api/agent-network/policies

List all Agent Network Policies

Returns a list of all Agent Network policies for the account.

4 status codes
200A JSON Array of Agent Network policies
created_atstringrequired
Timestamp when the policy was created.
descriptionstringrequired
Optional human-readable description.
destination_provider_idsarray<string>required
Agent Network provider ids (returned by the providers API) the source groups can reach.
enabledbooleanrequired
Whether the policy is enabled.
guardrail_idsarray<string>required
Agent Network guardrail ids attached to this policy.
idstringrequired
Policy ID
limitsobjectrequired
Token and budget caps attached directly to the policy. These compose with any guardrail-level checks.
namestringrequired
Display name for the policy.
source_groupsarray<string>required
NetBird group ids whose members are allowed to call the destination providers.
updated_atstringrequired
Timestamp when the policy 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.