---
title: "Execute server console command"
method: POST
path: "/v1/server-console/execute"
tags: ["Server Console"]
---

# Execute server console command

`POST /v1/server-console/execute`

Execute a single server debug console command and return its complete output. Intended for
integrations; interactive terminals should use `POST /v1/server-console/session` to receive
output as it is produced.

Output is returned as plain text with terminal color sequences removed. Unknown or failed
commands are reported in the output text, not by HTTP status. The `down` command initiates
server shutdown after the response is sent. The `exit` command has no effect.

Requires SERVER_CONSOLE access right.

## Request body

- object
  - `command` string, required — Console command line

## Response `200`

Command executed

- object
  - `output` string — Command output
  - `shutdownInitiated` boolean — True if the command initiated server shutdown

## Other responses

- `400` — Missing or invalid JSON body, empty command, or command longer than 255 characters
- `401` — Unauthorized
- `403` — User does not have SERVER_CONSOLE access right

## Changes

- **2026-09-30** `a8eea04a807d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/server-console/execute/post.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/129789f8868f?raw)