---
title: "Update server action"
method: PUT
path: "/v1/server-actions/{action-id}"
tags: ["Server Actions"]
---

# Update server action

`PUT /v1/server-actions/{action-id}`

Update an existing server action. Only the fields provided in the request body will be modified.

## Path parameters

- `action-id` integer, required

## Request body

- ServerActionUpdate
  - `name` string — Action name
  - `type` integer — Action type
  - `isDisabled` boolean — Whether the action is disabled
  - `data` string — Action data (command, message, or script name depending on type)
  - `recipientAddress` string — Recipient address
  - `emailSubject` string — Email subject
  - `notificationChannelName` string — Notification channel name

## Response `200`

Server action updated successfully

- ServerAction — Server action configuration
  - `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
  - `recipientAddress` string — Recipient address (supports macros)
  - `emailSubject` string — Email subject (supports macros)
  - `notificationChannelName` string — Notification channel name

## Other responses

- `400` — Invalid action ID
- `401` — Unauthorized
- `403` — User does not have MANAGE_ACTIONS access right
- `404` — Server action not found
- `409` — Action with this name already exists
- `500` — Database failure

## Changes

- **2026-05-08** `c6aaf3632e48` — 4 warning
  - removed the optional property `command` from the response with the `200` status
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `message` from the response with the `200` status
  - removed the optional property `scriptName` from the response with the `200` status

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/server-actions/:action-id/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/c8712ec36396?raw)