REST API Reference

Overview

The Aegis Cloud API is a RESTful interface that allows you to programmatically interact with your fleet, execute tasks, and retrieve telemetry data. All API endpoints are authenticated using Bearer tokens.

Base URL: https://api.aegiscloud.in/api/v1

Authentication

To authenticate with the API, you must provide a valid API key in the Authorization header of your HTTP requests.

Authorization: Bearer aegis_live_xxxxxxxxx

Endpoints

GET/devices

Retrieves a paginated list of all devices enrolled in your organization.

curl -X GET "https://api.aegiscloud.in/api/v1/devices" \
  -H "Authorization: Bearer $API_KEY"
POST/tasks/execute

Dispatches a new automation task to one or more devices.

curl -X POST "https://api.aegiscloud.in/api/v1/tasks/execute" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "devices": ["DEV-001", "DEV-002"], "command": "clean_temp", "timeout": 60 }'
WS/ws/telemetry

Connects to the real-time WebSocket firehose for live device metrics.

Requires specialized WebSocket client libraries configured with Bearer authentication.