---
title: "Update object"
method: PUT
path: "/objects/{object-id}"
tags: ["Objects"]
---

# Update object

`PUT /objects/{object-id}`

Updates object properties. Only provided fields are updated.
Array fields are replaced entirely (not merged).

## Path parameters

- `object-id` string, required

## Request body

- ObjectModificationData
  - `name` string
  - `primaryName` string
  - `alias` string
  - `nameOnMap` string
  - `acl` AccessListElement[]
    - `userId` integer
    - `accessRights` integer — Bit flags: - 0x00000001: READ - 0x00000002: MODIFY - 0x00000004: CREATE - 0x00000008: DELETE - 0x00000010: READ_ALARMS - 0x00000020: ACL - 0x00000040: UPDATE_ALARMS - 0x00000080: SEND_EVENTS - 0x00000100: CONTROL - 0x00000200: TERM_ALARMS - 0x00000400: PUSH_DATA - 0x00008000: MAINTENANCE
  - `inheritAccessRights` boolean
  - `customAttributes` object
  - `autoBindFilter` string
  - `description` string
  - `geolocation` Geolocation
    - `type` integer — 0: UNSET, 1: MANUAL, 2: GPS, 3: NETWORK
    - `latitude` number, double
    - `longitude` number, double
    - `accuracy` integer — Accuracy in meters
    - `timestamp` integer — Unix timestamp
  - `postalAddress` PostalAddress
    - `country` string
    - `region` string
    - `city` string
    - `district` string
    - `streetAddress` string
    - `postcode` string
  - `objectFlags` integer
  - `objectFlagsMask` integer

## Response `200`

Object updated successfully

## Other responses

- `400` — Invalid request
- `401` — Access denied
- `404` — Object not found

## Changes

- **2026-01-30** `32f48ec94aec` — 1 info
  - endpoint added
- **2023-02-23** `9c09a2aad349` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/objects/:object-id/put.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/revisions/32f48ec94aec/schema)