---
title: "Delete user variable"
method: DELETE
path: "/v1/users/{user-id}/variables/{variable-name}"
tags: ["Users"]
---

# Delete user variable

`DELETE /v1/users/{user-id}/variables/{variable-name}`

## Request

- Base URL: `http://127.0.0.1:8000`
- URL: `http://127.0.0.1:8000/v1/users/{user-id}/variables/{variable-name}`
- Auth: HTTP bearer

Delete a single variable of the user. Deleting a variable that does not exist is not
an error. A user may delete their own variables; deleting another user's variables
requires MANAGE_USERS access right.

## Path parameters

- `user-id` integer, required
- `variable-name` string, required

## Response `204`

Variable deleted

## Other responses

- `400`: Invalid user ID
- `401`: Unauthorized
- `403`: Access denied (not self and no MANAGE_USERS right)
- `500`: Database failure

## Changes

- **2026-10-14** `2b33ef4bdb15`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/users/:user-id/variables/:variable-name/delete.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/740d85ba6674?raw)