APIAnomaly

List findings

List findings (SOC triage queue); start_time/end_time bound the finding's last active bucket (last_bucket).

GET
/anomaly/findings

List findings (SOC triage queue); start_time/end_time bound the finding's last active bucket (last_bucket).

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_anomaly_detection

Query Parameters

offset?integer

Number of items to skip before returning results.

Formatint32
Range0 <= value
Default0
limit?integer

Maximum number of items to return per page.

Formatint32
Range0 <= value <= 256
Default10
status?array<>
severity?array<>
detector?array<>
subject_type?string

What a finding is about: a person or a running agent.

Value in"user""agent_instance"
subject_id?array<string>
metric?array<string>
start_time?string
Formatdate-time
end_time?string
Formatdate-time
sort?string
Default"recent"
Value in"recent""severity""score"
sort_order?string

Direction to sort results.

Default"desc"
Value in"asc""desc"

Response Body

The request has succeeded.

application/json
  1. response

A page of results together with its paging information.

items*array<>

The items in this page.

meta*

Paging information for a list response.

curl -X GET "https://example.com/anomaly/findings"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "detector": "llm_cost_spike",      "family": "baseline",      "grain": "hour",      "metric": "string",      "dimension": "string",      "dimension_display": "string",      "subject_type": "user",      "subject_id": "string",      "subject_display_name": "string",      "bucket": "2019-08-24T14:15:22Z",      "last_bucket": "2019-08-24T14:15:22Z",      "severity": "low",      "status": "open",      "observed": 0.1,      "evidence": {        "baseline": {          "window_days": 0,          "n": 0,          "mean": 0.1,          "stddev": 0.1,          "median": 0.1,          "mad": 0.1,          "mean_ad": 0.1        },        "scoring": {          "robust_score": 0.1,          "z_score": 0.1,          "dispersion_basis": "mad",          "threshold": 0.1,          "floor": 0.1,          "abs_delta": 0.1,          "rel_factor": 0.1        },        "peer": {          "rank": 0.1,          "n": 0        },        "slice": {          "hour": 0,          "dow_class": "string",          "fell_back": true        },        "prior": {          "max": 0.1,          "p90": 0.1,          "exceeded": true        },        "novelty": {          "keys": [            "string"          ],          "keys_display": [            "string"          ],          "new_for_org": true,          "dormancy_days": 0        },        "threshold": {          "floor": 0.1        },        "off_hours": {          "min_calls": 0.1,          "history_days": 0        }      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "status_changed_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "total": 0,    "offset": 0,    "limit": 0  }}