---
title: "Create or update a single asset property"
method: PUT
path: "/v1/objects/{object-id}/asset-properties/{name}"
tags: ["Objects"]
---

# Create or update a single asset property

`PUT /v1/objects/{object-id}/asset-properties/{name}`

Upsert a single asset property identified by name. The name is taken from the URL
path (URL-encoded). The attribute name must be defined in the asset management
schema and the value is validated against that schema (data type, range, enum,
etc.). The target object must be an asset.

## Path parameters

- `object-id` integer, required
- `name` string, required

## Request body

- object
  - `value` string, required — Property value. Validated against the asset management schema.

## Response `200`

Property created or updated.

- object
  - `name` string
  - `value` string

## Other responses

- `400` — Object is not an asset, invalid request body, or value rejected by schema validation.
- `401` — Unauthorized
- `403` — User does not have modify access to the object
- `404` — Object does not exist, or attribute name is not defined in the asset management schema

---

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