API Reference
Ingest Endpoint
Send metrics to Argus via the ingest API.
Endpoint
POST /api/v1/ingestHeaders
| Header | Required | Description |
|---|---|---|
X-API-Key | Yes | Your API key |
Content-Type | Yes | application/json |
Request Body
{
"host": "web-server-01",
"timestamp": "2024-01-15T14:30:00Z",
"metrics": {
"cpu_percent": 42.5,
"memory_percent": 68.2,
"disk_percent": 55.0
},
"tags": {
"environment": "production",
"service": "api-gateway",
"region": "us-east-1"
},
"docker_containers": [
{
"name": "nginx",
"image": "nginx:1.25",
"status": "running",
"cpu_percent": 2.1,
"memory_usage": 52428800
}
],
"processes": [
{
"name": "node",
"pid": 1234,
"cpu_percent": 15.3,
"memory_rss": 104857600
}
]
}Response
Success (200)
{
"status": "ok",
"events_accepted": 1
}Errors
| Status | Description |
|---|---|
| 401 | Invalid or missing API key |
| 429 | Event quota exceeded (purchase PAYG credits or upgrade) |
| 422 | Invalid request body |
Example
curl -X POST https://api.tryargus.cloud/api/v1/ingest \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"host": "web-server-01",
"metrics": {
"cpu_percent": 42.5,
"memory_percent": 68.2
}
}'