Bulk Get Fragments Used By

POST /rest/asset/v2/fragment/bulk/usedby

Returns, for each of the specified fragments, whether it is used and the number of places it is used (count) — not the referencing assets themselves. Maximum 50 assets per request.

Operation ID: bulkUsedByUsingPOST_fragment
Permissions: Read-Only Assets, Access Design Studio
Request format: application/json
Returns: BulkUsedByResponse, ErrorResponse

Parameters

Query 1

access_token string required

Token for Authorization

The Request Builder sends the token in the Authorization header instead, so it never appears in URLs.

Header 1

x-app-type string required

Application type header

Request body

application/json · required · BulkUsedByRequest · 1 properties

assetIds array of string required

Asset IDs to query. Maximum 50 per request.

Responses

200 OK BulkUsedByResponse

success boolean

requestId string

result array of BulkUsedByItemDTO

Model BulkUsedByItemDTO

id string

name string

count integer (int32)

Number of places the asset is used.

used boolean

Whether the asset is used by any other asset.

Generated example

{
  "success": true,
  "requestId": "123",
  "result": [
    {
      "id": "123",
      "name": "Example name",
      "count": 123,
      "used": true
    }
  ]
}

Default Error ErrorResponse

success boolean

requestId string

errors array of ContentWaveErrorDTO

Model ContentWaveErrorDTO

key string

message string

code string

dynamicMessage string

type string

Severity of the entry: info, warning, or error.

source string

Origin of the entry, e.g. validation, template, fragment, message_render, asset_publish.

errorMessage string

errorPosition object

Location in the content the entry refers to (for script/validation errors).

Generated example

{
  "success": true,
  "requestId": "123",
  "errors": [
    {
      "key": "string",
      "message": "string",
      "code": "string",
      "dynamicMessage": "string",
      "type": "string",
      "source": "string",
      "errorMessage": "string",
      "errorPosition": {
        "line": 123,
        "column": 123
      }
    }
  ]
}

Referenced models

Generated from swagger-asset.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.