---
title: "Unbind agent tunnel from node"
method: POST
path: "/v1/objects/{object-id}/unbind-agent-tunnel"
tags: ["Agent Tunnels"]
---

# Unbind agent tunnel from node

`POST /v1/objects/{object-id}/unbind-agent-tunnel`

Remove tunnel binding from the node, revoke the agent certificate issued on bind, and shut down the node's active tunnel if there is one. Succeeds also when the node has no bound tunnel. Requires MANAGE_AGENT_TUNNELS system access right.

## Path parameters

- `object-id` integer, required

## Response `204`

Tunnel unbound

## Other responses

- `400` — Object is not a node
- `401` — Unauthorized
- `403` — Access denied
- `404` — Object with given ID does not exist

## Changes

- **2026-09-30** `500c0eebeca8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/unbind-agent-tunnel/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)