Sentrabyte Endpoint API v1

QA fixture. Sentrabyte Endpoint is a made-up antivirus product used to test integrations. All data is synthetic.

Authentication

Send your API token on every request: Authorization: Bearer <token>. Requests without a valid token get 401.

All endpoints are under /api/v1, answer JSON and are read-only.

GET /api/v1/account

Returns the account the token belongs to. Use it to check a token. Example: {"account":{"id":"acc-1","name":"..."},"api_version":"1"}

GET /api/v1/detections

Lists malware detections, newest first.

Query parameters

Response

{
  "data": {
    "detections": [
      {
        "detection_id": "string, unique",
        "threat": { "name": "string", "category": "string" },
        "risk": "info | low | medium | high | critical",
        "first_seen": "ISO 8601 UTC timestamp",
        "endpoint": { "id": "string", "hostname": "string, the computer name", "os": "string" },
        "file": { "path": "string", "sha256": "string" },
        "state": "detected | quarantined | removed | allowed"
      }
    ],
    "total": 0
  }
}

GET /api/v1/endpoints

Lists protected computers: {"data":{"endpoints":[{"id":"string","hostname":"string","last_seen":"ISO 8601","protection":"on | off"}]}}