# (NEW!) Update Collection

Update a collection's name, assets, metadata, and/or security templates in a single request. All fields are optional — only provided fields are applied, and omitted fields remain unchanged.

Asset Updates (collectionUpdates):
- add — appends the provided fileIds to the existing asset set.
- remove — removes the provided fileIds from the existing asset set.
- replace — replaces the entire asset set with the provided fileIds.

Metadata Updates (metadata):
- Partial-update semantics: only the attributes included in the array are changed. Attributes not listed remain untouched.
- metadata.value supports both standard attribute values and table-type values. 

Security Templates (securityTemplateIds):
- When provided, replaces the collection's existing security template assignments entirely.
- When omitted, existing security template assignments remain unchanged.

The User submitting the request must have permission to edit the Collection. The User must have View access to any Assets being added to or removed from the Collection.

Endpoint: PATCH /collections/{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 collection to update.
    Example: "e8b8e00f-83ba-49e3-894b-823e5e5bfa2d"

## Request fields (application/json):

  - `collectionName` (string)
    New display name for the collection.
    Example: "Hooli Assets"

  - `securityTemplateIds` (array)
    Replaces existing security template assignments. Omit to leave current assignments unchanged.
    Example: ["ccf72d28-87a2-4ff4-b5a7-1e54a1155a2a","e13fc6d5-7ad9-453f-9bca-614e691ef74e"]

  - `collectionUpdates` (object)
    Defines an operation to add, remove, or replace assets in the collection. Accepts a list of fileIDs.

  - `collectionUpdates.operation` (string, required)
    The operation to perform on the collection's asset set.
    Enum: "add", "remove", "replace"

  - `collectionUpdates.fileIds` (array, required)
    Asset file IDs to apply the operation against.
    Example: ["4a92ca5e-6c62-4bea-b3d2-e7f3bac7c399","508c0b31-f698-412d-8c4e-4ff39ac12410"]

  - `metadata` (array)
    Metadata key/value pairs to update. Only listed attributes are changed — others remain untouched.

  - `metadata.name` (string, required)
    The metadata attribute name.
    Example: "Department"

  - `metadata.value` (any, required)
    The attribute value. Supports standard attribute values (string, date) and table-type values.
    Example: "Marketing"

## Response 200 fields (application/json):

  - `status` (string)

  - `message` (string)

  - `collectionId` (string)

## Response 206 fields (application/json):

  - `status` (string)

  - `message` (string)

  - `collectionId` (string)

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