---
title: "Set observation state"
method: PUT
path: "/v1/ai/observations/{observation-id}/state"
tags: ["AI Operators"]
---

# Set observation state

`PUT /v1/ai/observations/{observation-id}/state`

Acknowledge or dismiss an AI operator observation (or return it to the "new" state). Requires "update alarms" access to the observation's source object; server-level observations require the "manage AI operators" system access right.

## Path parameters

- `observation-id` integer, required

## Request body

- object
  - `state` 'new' | 'acknowledged' | 'dismissed', required — New observation state

## Response `204`

State updated

## Other responses

- `400` — Invalid observation ID or state
- `403` — Insufficient access rights
- `404` — Observation not found
- `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/revisions/14d93e5115dd/schema)