Skip to content

Zenoss API

The Zenoss API enables customized integrations with Zenoss Cloud services through a RESTful interface. The following services are supported:

All Zenoss API endpoints require HTTPS, expect JSON in the request body when a body is required, and return a JSON response.

You must have an authentication key to send requests to a Zenoss API endpoint. The key is sent in the zenoss-api-key header of each request. Note that the user management service requires a different type of key than all other services.

All API examples use curl to send a JSON request from a Bash shell to an endpoint. Also, all examples use YOUR-API-ENDPOINT and YOUR-API-KEY as placeholders for endpoints and authentication keys, respectively.

Zenoss API endpoints

Zenoss Cloud supports the API endpoints in the following table.

Stack Zenoss Domain Endpoint Zenoss Domain Endpoint End of Life Date Virtana Domain Endpoint Virtana Domain IPv6 Endpoint
Production 1 (Iowa) api.zenoss.io 12/15/2025 api.virtana.ai api-zing-preview-ipv6.virtana.ai
Production 2 (Las Vegas) api2.zenoss.io 12/15/2025 api2.virtana.ai api-zcloud-prod2-ipv6.virtana.ai
Production 3 (Sydney) api3.zenoss.io 12/15/2025 api3.virtana.ai api-zcloud-prod3-ipv6.virtana.ai
Production 4 (Frankfurt) api.zenoss.eu 12/15/2025 api4.virtana.ai api-zcloud-emea-ipv6.virtana.ai
Preview (Iowa) api-zing-preview.zenoss.io 11/1/2025 api-zing-preview.virtana.ai api-zing-preview-ipv6.virtana.ai

If you are unsure which endpoint to use, please contact Zenoss support.

Tip

When you generate a new Zenoss API key, the dialog box displays your organization's endpoint.

gRPC methods for data receiver resources

For high-performance agents or integrations, the data receiver service also supports gRPC/Protobuf.