---
title: "List server actions"
method: GET
path: "/v1/server-actions"
tags: ["Server Actions"]
---

# List server actions

`GET /v1/server-actions`

Retrieve a list of all server actions defined in the system.

## Response `200`

Server actions retrieved successfully

- ServerAction[]
  - `id` integer — Action ID
  - `guid` string, uuid — Action GUID
  - `name` string — Action name
  - `type` integer — Action type: 0=execute command on server, 1=execute command on remote node via agent, 3=send notification, 4=forward event, 5=execute server-side script, 7=execute command via SSH
  - `typeDescription` string — Human-readable action type description
  - `isDisabled` boolean — Whether the action is disabled
  - `isMarkdown` boolean — Whether the notification message body is markdown
  - `recipientAddress` string — Recipient address (supports macros)
  - `emailSubject` string — Email subject (supports macros)
  - `notificationChannelName` string — Notification channel name
  - `command` string — Action payload for command-type actions (type 0, 1, or 7). Exactly one of command/message/scriptName/data is present, selected by the action type.
  - `message` string — Action payload for notification actions (type 3).
  - `scriptName` string — Action payload for script actions (type 5).
  - `data` string — Action payload for other action types (e.g. type 4, forward event).

## Other responses

- `401` — Unauthorized
- `403` — User does not have MANAGE_ACTIONS or EPP access rights

## Changes

- **2026-07-30** `02a14829a49c` — 1 info
  - added the optional property `items/isMarkdown` to the response with the `200` status
- **2026-06-10** `30e75dc6a94c` — 4 info
  - added the optional property `items/command` to the response with the `200` status
  - added the optional property `items/data` to the response with the `200` status
  - added the optional property `items/message` to the response with the `200` status
  - added the optional property `items/scriptName` to the response with the `200` status
- **2026-05-08** `c6aaf3632e48` — 4 warning
  - removed the optional property `items/command` from the response with the `200` status
  - removed the optional property `items/data` from the response with the `200` status
  - removed the optional property `items/message` from the response with the `200` status
  - removed the optional property `items/scriptName` from the response with the `200` status

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/server-actions/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-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/b04ea2fbcedb/schema)