---
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

## Changes

- **2026-09-17** `a203de7e5d7d` — 1 info
  - removed the non-success response with the status `503`
- **2026-09-17** `a81265c49fa9` — 1 info
  - added the non-success response with the status `503`
- **2026-07-13** `e8c39bd1ae5d` — 1 info
  - added the non-success response with the status `404`
- **2026-07-11** `38f213f6e6b4` — 1 info
  - endpoint added
- **2026-05-08** `c6aaf3632e48` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/observations/:observation-id/state/put.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/2827204d68d9?raw)