---
title: "Get standing instructions history"
method: GET
path: "/v1/ai/operators/{operator-id}/instructions-history"
tags: ["AI Operators"]
---

# Get standing instructions history

`GET /v1/ai/operators/{operator-id}/instructions-history`

Retrieve previous versions of the instance's standing instructions, most recent first. A record is written whenever the instructions change (model update, administrator edit, or reset). The number of records kept per instance is limited by AIOperator.Instructions.HistoryDepth.

## Path parameters

- `operator-id` integer, required

## Response `200`

History records

- AiOperatorInstructionsHistoryRecord[]
  - `id` integer — Record identifier
  - `iteration` integer — Instance iteration at which the instructions changed
  - `timestamp` string, date-time — Time of the change
  - `previousText` string — Standing instructions text before the change

## Other responses

- `403` — Insufficient access rights
- `404` — Instance not found

## 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-09-07** `4390015280c9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/operators/:operator-id/instructions-history/get.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/0209e896a2a0?raw)