NetBird Full API Reference + Read-Only MCP Prototype
GET/api/integrations/agent-network/managed-proxy

Retrieve managed Agent Network gateway status

Reports the account's managed gateway deployment and its derived state, including disabled for a deployment that is turned off. Returns 404 when the account has no managed deployment.

5 status codes
200The account's managed gateway deployment
endpointstringrequired
The account's gateway hostname.
idstringrequired
Managed proxy deployment ID.
messagestringoptional
Failure detail reported by the rollout. Only set when state is `failed`.
regionstringoptional
Region of the cluster hosting the deployment.
statestringrequired
Derived deployment state. `provisioning` until the gateway is rolled out and connected, `ready` while the gateway actively serves the endpoint, `failed` when the rollout reported a failure, `disabled` while the gateway is turned off and the endpoint is not served.
Allowed:provisioningreadyfaileddisabled
401Requires authentication
403Forbidden
404Resource not found
500Internal Server Error

Error handling

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.