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

Retrieve an Agent Network Policy

Get information about a specific Agent Network policy.

1 parameter
policyIdstringrequired
The unique identifier of an Agent Network policy

6 status codes
200An Agent Network policy object
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.
400Bad Request
401Requires authentication
403Forbidden
404Resource not found
500Internal Server Error

Error handling

A 400 is returned: Bad Request. A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 404 is returned: Resource not found. A 500 is returned: Internal Server Error.