# (NEW!) Update Metadata Group

Partially update an existing metadata group. Only fields included in the request body will be updated — omitted fields remain unchanged.

When attributeIds is provided, the existing attribute list is fully replaced in the order given.

Fields that cannot be updated: searchField.

The user submitting the request must have the Metadata Management admin privilege.

Endpoint: PATCH /metadata/group/{id}
Version: 1.5
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation.

  - `Content-Type` (string, required)
    Enum: "application/json"

## Path parameters:

  - `id` (string, required)
    The unique ID of the metadata group to update.
    Example: "52ce0235-02cc-46f6-8bdb-05238c76bf83"

## Request fields (application/json):

  - `name` (string)
    Updated display name of the group.
    Example: "Updated Group Name"

  - `attributeIds` (array)
    Updated ordered list of attribute IDs. Replaces the existing list entirely. Order is preserved.
    Example: ["01dc8715-c660-44cb-b3a4-70f4779e6651","013ad220-b377-432d-bc6d-b1614dbb82c1"]

  - `isGroupNameVisible` (boolean)
    Whether the group name is visible when rendered on an asset.
    Example: true

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the group.
    Example: "52ce0235-02cc-46f6-8bdb-05238c76bf83"

  - `name` (string)
    Display name of the group.
    Example: "Product Information"

  - `searchField` (string)
    System-generated slug derived from the group name. Immutable after creation.
    Example: "product_information"

  - `customerId` (string)
    ID of the customer/tenant.
    Example: "1739271540099"

  - `createdBy` (string)
    UUID of the user who created the group.
    Example: "dc63db1b-1e63-43bc-877e-418931b6895c"

  - `createdEpoch` (integer)
    Creation timestamp in Unix milliseconds.
    Example: 1773070355217

  - `createdDate` (string)
    Human-readable creation date in ISO 8601 format.
    Example: "2026-03-20T12:05:27Z"

  - `lastUpdatedBy` (string)
    UUID of the user who last updated the group.
    Example: "dc63db1b-1e63-43bc-877e-418931b6895c"

  - `lastUpdatedEpoch` (integer)
    Last updated timestamp in Unix milliseconds.
    Example: 1773070355217

  - `lastUpdatedDate` (string)
    Human-readable last updated date in ISO 8601 format.
    Example: "2026-03-20T12:05:27Z"

  - `isGroupNameVisible` (boolean)
    Whether the group name is visible when rendered on an asset.

  - `usedIn` (object)
    Describes where the group is currently referenced. Present on GET by ID responses.

  - `usedIn.metadataTemplates` (array)
    Templates that reference this group. Empty array if none.

  - `usedIn.metadataTemplates.id` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `usedIn.metadataTemplates.name` (string)
    Example: "Product Content"

  - `attributes` (array)
    Ordered list of attributes in the group.

  - `attributes.id` (string)
    ID of the attribute.
    Example: "01dc8715-c660-44cb-b3a4-70f4779e6651"

  - `attributes.name` (string)
    Display name of the attribute.
    Example: "Product Name"

  - `attributes.attributeType` (string)
    Type of the attribute.
    Example: "textbox"

## Response 400 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 401 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 403 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 404 fields (application/json):

  - `message` (string)

  - `detail` (string)