---
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.

## Changes

> 71 revisions in range; 8 could not be searched.

- **2026-05-18** `5a88701fa088` — 1 info
  - endpoint added
- **2026-05-08** `c6aaf3632e48` — 1 breaking
  - api path removed without deprecation

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