---
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.
Requires modify access to the object or the "edit responsible users" access right.

## 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 or "edit responsible users" 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/revisions/e9197a1d31c4/schema)