REST API

Hyprwatch provides a REST API for programmatic access to your fleet.

Authentication

All API requests require an API key. Include it in the Authorization header: 

Authorization: Bearer hw_live_xxxxx

Base URL

https://hyprwatch.cloud/api/v1

Endpoints

GET /whoami

Get information about the current API key.

GET /shadows

List all shadows (hosts) in your organization.

POST /query

Execute a SQL query across your fleet.

GET /queries

List saved queries.

Rate Limits

API requests are rate limited to 100 requests per minute per organization. Rate limit headers are included in all responses:

  • X-RateLimit-Limit - Maximum requests per minute
  • X-RateLimit-Remaining - Remaining requests