Bulk Edit Assets

Perform metadata edits and/or reassign Security Templates to one or more Assets. Assets are identified by Object ID. If multiple Assets are specified, the same metadata and/or security edits will be applied to all Assets in the request.

Each Metadata Attribute is identified by a Metadata Definition ID.

The user performing the bulk edit must have the Edit Metadata permission granted on each Asset being edited.

Average Response Time: 605ms

SecurityApiKeyAuth or BasicAuth
Request
header Parameters
X-API-Key
required
string

Customer-specific API key required to invoke API.

Authorization
required
string

Provided by Authentication Token creation operation

AccessToken
required
string

JWT token provided by Authentication Token creation operation.

Content-Type
required
string
Value: "application/json"
Request Body schema: application/json
required

The Request Body must be a JSON object. The object must contain metadata and/or securityTemplateIds as well as an array of objectIds.

metadataTemplateId
required
string <uuid> = 36 characters

Metadata Template ID to assign to the edited Assets.

Array of AssetBulkEditStringValue (object) or AssetBulkEditDateValue (object) or AssetBulkEditRestrictedVocabularyValue (object) or AssetBulkEditMultiValue (object) or AssetBulkEditGridValue (object)

An array of metadata attribute operations

objectIds
required
Array of strings <uuid>

An array of Asset Object IDs

securityTemplateIds
Array of strings <uuid>

An array of Security Template IDs.

securityTemplateOp
string

Operation to either replace or append to the currently assigned list of Security Template IDs with the provided list of Security Template IDs.

Enum: "replace" "append"
Responses
200

Successful operation

400

Invalid Request

401

Unauthorized. Missing Authorization or AccessToken or expired token

403

Forbidden. Missing X-API-key

patch/asset
Request samples
application/json
{
  • "metadataTemplateId": "ea6eb24d-adef-4080-bd02-f64f567c437f",
  • "metadataDocument": [
    ],
  • "objectIds": [
    ],
  • "securityTemplateIds": [
    ],
  • "securityTemplateOp": "replace"
}
Response samples
application/json
{
  • "jobId": "5fa57655-c56c-47d3-a409-751fd5fd9735",
  • "collectionId": "7c6a6a3b-cac0-4218-be3b-515e0f9cb967"
}