Recommendations

{
  "data": {
    "items": [
      {
        "resourceUid": "i-0abc123def456",
        "resourceName": "idle-dev-server",
        "resourceType": "ec2",
        "provider": "aws",
        "cloudAccountId": "123456789012",
        "cloudAccountName": "AWS Prod",
        "recommendationCount": 3,
        "openCount": 2,
        "totalSavingsUsd": 52.56
      }
    ],
    "total": 45,
    "page": 1,
    "limit": 10,
    "hasMore": true
  }
}

{
  "data": {
    "items": [
      {
        "ruleId": "RC-212",
        "title": "Azure managed disk is unattached — verify and delete if not needed",
        "category": "orphan",
        "severity": "low",
        "resourceCount": 36,
        "openCount": 35,
        "totalSavingsUsd": 5.00
      }
    ],
    "total": 8,
    "page": 1,
    "limit": 10,
    "hasMore": false
  }
}

{
  "data": {
    "items": [
      {
        "id": "rec_001",
        "resourceUid": "i-0abc123def456",
        "resourceName": "idle-dev-server",
        "resourceType": "ec2",
        "ruleId": "RC-001",
        "title": "Idle EC2 Instance",
        "description": "This instance has had less than 5% CPU utilization over the past 14 days.",
        "currentCostUsd": 52.56,
        "optimizedCostUsd": 0.00,
        "savingsUsd": 52.56,
        "status": "open",
        "severity": "high",
        "category": "idle",
        "remediation": "Consider stopping or terminating this instance if it is not needed.",
        "consoleUrl": "https://console.aws.amazon.com/ec2/home?region=us-east-1#Instances:instanceId=i-0abc123def456",
        "provider": "aws",
        "cloudAccountId": "123456789012",
        "cloudAccountName": "AWS Prod",
        "actionType": "stop",
        "evidence": {
          "metric": "CPUUtilization",
          "windowDays": 14,
          "p95": 3.1
        },
        "generatedAt": "2025-01-20T08:00:00Z"
      }
    ],
    "total": 36,
    "page": 1,
    "limit": 5,
    "hasMore": true
  }
}

{
  "data": {
    "totalOpen": 23,
    "totalSavings": 1250.80,
    "criticalCount": 2,
    "highCount": 8,
    "resourceCount": 18,
    "awsResources": 10,
    "gcpResources": 5,
    "azureResources": 3,
    "appliedCount": 12,
    "dismissedCount": 5,
    "optimisedCount": 3
  }
}

curl -X PATCH https://zopnight.com/api/recommendations/rec_001 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "status": "applied" }'

{
  "data": {
    "statuses": ["open", "applied", "dismissed", "optimised"],
    "severities": ["critical", "high", "medium", "low", "info"],
    "categories": ["idle", "rightsizing", "schedule", "orphan", "compliance", "discount", "governance"],
    "providers": ["aws", "gcp", "azure"]
  }
}

{
  "data": [
    { "provider": "aws", "totalOpen": 12, "totalSavings": 820.50, "criticalCount": 1, "highCount": 5 },
    { "provider": "gcp", "totalOpen": 6, "totalSavings": 310.00, "criticalCount": 0, "highCount": 2 },
    { "provider": "azure", "totalOpen": 5, "totalSavings": 120.30, "criticalCount": 1, "highCount": 1 }
  ]
}

{
  "data": {
    "scopes": ["organisation", "cloud_account"],
    "actions": ["notify"],
    "facets": [
      { "attr": "category",     "label": "Category",      "op": ["in", "notIn"], "values": ["idle", "rightsizing", "schedule", "orphan", "compliance", "discount", "governance"] },
      { "attr": "severity",     "label": "Severity",      "op": ["in", "notIn"], "values": ["critical", "high", "medium", "low", "info"] },
      { "attr": "resourceType", "label": "Resource type", "op": ["in", "notIn"], "values": ["ec2", "rds", "disk", "gce", "azure-vm", "..."] }
    ]
  }
}

curl -X POST https://zopnight.com/api/recommendations/policies/validations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "selector": { "all": [{ "attr": "severity", "op": "in", "values": ["critical"] }] },
      "notify":   { "channels": ["ch_abc123"] }
    }
  }'

{ "data": { "valid": true, "errors": [] } }

{
  "data": {
    "valid": false,
    "errors": [
      { "field": "spec.notify.channels", "message": "at least one channel is required" }
    ]
  }
}

{
  "data": {
    "items": [
      {
        "id":          "pol_abc123",
        "domain":      "recommendation",
        "targetType":  "organisation",
        "targetId":    "org_xyz",
        "name":        "Critical findings → Slack",
        "description": "Route critical and high severity findings to #alerts",
        "spec": {
          "selector": { "all": [{ "attr": "severity", "op": "in", "values": ["critical", "high"] }] },
          "notify":   { "channels": ["ch_abc123"] }
        },
        "enabled":   true,
        "createdBy": "admin@company.com",
        "createdAt": "2025-01-15T10:30:00Z",
        "updatedAt": "2025-01-15T10:30:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20,
    "hasMore": false
  }
}

curl -X POST https://zopnight.com/api/policies \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain":      "recommendation",
    "targetType":  "organisation",
    "targetId":    "org_xyz",
    "name":        "Critical findings → Slack",
    "description": "Route critical and high severity findings to #alerts",
    "spec": {
      "selector": {
        "all": [
          { "attr": "severity", "op": "in", "values": ["critical", "high"] }
        ]
      },
      "notify": {
        "channels": ["ch_abc123"]
      }
    }
  }'

{
  "data": {
    "id":         "pol_abc123",
    "domain":     "recommendation",
    "targetType": "organisation",
    "targetId":   "org_xyz",
    "name":       "Critical findings → Slack",
    "enabled":    true,
    "createdAt":  "2025-01-15T10:30:00Z"
  }
}

curl -X PATCH https://zopnight.com/api/policies/pol_abc123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'