---
title: "Disable an object tool"
method: POST
path: "/v1/object-tools/{tool-id}/disable"
tags: ["Object Tools"]
---

# Disable an object tool

`POST /v1/object-tools/{tool-id}/disable`

Sets the `disabled` flag on the tool so that it is hidden from per-object tool lists
and cannot be executed. Requires SYSTEM_ACCESS_MANAGE_TOOLS.

## Path parameters

- `tool-id` integer, required

## Response `204`

Object tool disabled.

## Other responses

- `400` — Invalid tool ID.
- `403` — Insufficient access rights (SYSTEM_ACCESS_MANAGE_TOOLS required).
- `500` — Database failure.

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)