GET
/api/agent-network/budget-rules/{ruleId}Get an Agent Network budget rule
Retrieves an account-level budget rule by its unique identifier. Use ruleId to select the rule; the response includes its targets, limits, enforcement state, and creation and update timestamps.
ruleIdstringrequired
The unique identifier of the budget rule to retrieve.
200Returns the budget rule object, including its ID, name, enforcement state, targets, limits, and creation and update timestamps.
created_atstringrequired
enabledbooleanrequired
Whether the rule is enforced.
idstringrequired
Budget rule ID.
limitsobjectrequired
Token and budget caps attached directly to the policy. These compose with any guardrail-level checks.
namestringrequired
Display name for the budget rule.
target_groupsarray<string>required
NetBird group ids the rule binds. Empty plus empty target_users means account-wide.
target_usersarray<string>required
NetBird user ids the rule binds directly.
updated_atstringrequired
400Returned when the request is malformed or invalid.
401Returned when authentication is missing or invalid.
403Returned when the authenticated user is not permitted to retrieve the budget rule.
404Returned when the budget rule does not exist.
500Returned when an internal server error occurs.
Error handling
A 400 is returned when the request is malformed or invalid. A 401 is returned when authentication is missing or invalid; a 403 is returned when access is forbidden; a 404 is returned when the ruleId path parameter does not identify an existing budget rule; a 500 is returned for an internal server error.