---
title: "Query AI operator observations"
method: GET
path: "/v1/ai/observations"
tags: ["AI Operators"]
---

# Query AI operator observations

`GET /v1/ai/observations`

Retrieve observations recorded by AI operator instances, most recent first. Requires the "view event log" system access right.

## Query parameters

- `instance` integer
- `object` integer
- `state` 'new' | 'acknowledged' | 'dismissed'
- `since` string
- `limit` integer

## Response `200`

List of observations

- AiObservation[]
  - `id` integer — Unique observation identifier
  - `timestamp` string, date-time — Time the observation was recorded
  - `instanceId` integer — ID of the AI operator instance that recorded the observation
  - `severity` integer — Severity (0=normal, 1=warning, 2=minor, 3=major, 4=critical)
  - `title` string, nullable — Short observation title
  - `body` string, nullable — Detailed observation text
  - `objectId` integer — ID of the related object (0 if not related to a specific object)
  - `references` string[], nullable — References supporting the observation (event IDs, alarm IDs, DCI names, etc.)
  - `state` 'new' | 'acknowledged' | 'dismissed' — Observation triage state

## Other responses

- `400` — Invalid query parameters
- `403` — Insufficient access rights
- `500` — Database failure

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)