API Reference

Performs bulk metadata updates (collections, tags, related content, custom metadata) across multiple content items.

post
https://localhost:44395/api/admin/content/bulk-metadata-update

Behavior: Applies the specified property changes to all targeted content items. If the number of content items exceeds the configured MaxBulkMetadataInlineUpdateSize threshold, or if the background flag is set, the operation is queued as a batch action for asynchronous processing. Otherwise, the updates are applied inline. The "Asset Metadata" content definition is reserved and cannot be targeted.

Authorization: Requires a valid Bearer token.

Side Effects: Modifies metadata on all targeted content items. When processed in background mode, creates a batch job for asynchronous execution.

Error Scenarios: Returns 400 if the content definition is reserved, content IDs are missing, or property changes are missing.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean
Defaults to false

When true, forces background batch processing regardless of item count. Defaults to false.

Body Params

The payload containing the content IDs and property changes to apply.

Request model for applying bulk metadata updates across multiple content items.

uuid | null

The content definition ID scoping the update. Defaults to the asset content definition if null.

contentIds
array of uuids | null

The list of content item IDs to update.

contentIds
propertyChanges
array of objects | null

The list of property changes to apply to each content item.

propertyChanges
Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses
200

The bulk metadata update completed or was queued successfully.

Updated about 21 hours ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 21 hours ago