---
title: "Add or update a responsible user"
method: PUT
path: "/v1/objects/{object-id}/responsible-users/{user-id}"
tags: ["Objects"]
---

# Add or update a responsible user

`PUT /v1/objects/{object-id}/responsible-users/{user-id}`

Set the tag for a single responsible user or group. If the user is not yet
responsible for the object it is added; otherwise its tag is updated. The user
or group must exist. An absent or null tag is treated as an empty string.

## Path parameters

- `object-id` integer, required
- `user-id` integer, required

## Request body

- object
  - `tag` string, nullable — Responsible user tag (max 31 characters). Null or absent is treated as empty.

## Response `200`

Responsible user added or updated.

- object
  - `userId` integer
  - `tag` string

## Other responses

- `400` — User or group does not exist, or tag is too long.
- `401` — Unauthorized
- `403` — User does not have modify access to the object
- `404` — Object with given ID does not exist

---

[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)