Skip to main content
PATCH
Bulk-update governance metadata on many assets.

Authorizations

Authorization
string
header
required

Bearer access token obtained from /oauth/token.

Headers

Idempotency-Key
string
required

Required. A unique key (max 256 chars) that makes the write idempotent; reusing a key replays the original response. Send a fresh UUID per distinct request. See docs.

Maximum string length: 256
Example:

"b0f8e5a2-3c1d-4e6f-8a9b-0c1d2e3f4a5b"

Body

application/json

Bulk governance update. Applies patch to every id. tags are not supported in bulk (a non-null patch.tags is rejected). Employee ids are rejected with no partial apply.

ids
string<uuid>[]
required

Public asset ids to update (1 to 100).

Required array length: 1 - 100 elements

Public asset ids to update (1 to 100).

patch
object
required

Governance-only metadata update. Governance fields only - no name, device facts, status, create or delete.

Response

Assets updated.

Summary of a bulk governance update. The updated assets are not returned.

failedUpdates
integer<int32>

Number of assets that could not be updated.

Example:

2

successfulUpdates
integer<int32>

Number of assets successfully updated.

Example:

18