---
title: "PUT /bulk-asset-metadata"
method: PUT
path: "/bulk-asset-metadata"
tags: ["BulkMetadata"]
---

# PUT /bulk-asset-metadata

`PUT /bulk-asset-metadata`

Inserts metadata for multiple assets into a new account ID.

## Query parameters

- `api-version` string, required

## Request body

- BulkAssetMetadataRequestResponse — Response containing bulk asset metadata with pagination support
  - `continuationToken` string — Continuation token for pagination. Null when no more results are available.
  - `metadata` BulkAssetMetadataEntry[], required — Array of metadata entries (up to 10 per response)
    - `assetMetadata` AssetMetadata, required — Unified metadata observer for monitoring data assets across platforms
      - `id` string, required — Unique identifier of the asset metadata observer
      - `name` string — Display name of the asset metadata observer
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `createdAt` string, date-time — Creation timestamp (UTC)
      - `createdBy` string — Identity of the creating user
      - `lastModifiedAt` string, date-time — Last modification timestamp (UTC)
      - `lastModifiedBy` string — Identity of the last modifying user
      - `isDeleted` boolean — Soft deletion flag
      - `ETag` string — Entity tag for concurrency control
      - `type` string, required — Data source type classification
      - `typeProperties` AssetMetadataCommonProperties — Shared metadata properties across all data asset types
        - `inputDatasets` unknown[] — Input dataset definitions and schemas
          - unknown
        - `projection` unknown
      - `location` Location[] — Physical storage locations for file-based assets
        - `type` string, required — Storage type classification
        - `typeProperties` LocationTypeProperties, required — Storage-specific configuration properties for different location types
          - `fileSystem` string — File system or container name
          - `folderPath` string — Hierarchical path within the storage location
          - `accountName` string — Storage account name or endpoint identifier
          - `region` string — Geographic region or environment location
      - `format` string — Data format specification for structured assets
      - `schemaName` string — Database schema name for SQL-based assets
      - `tableName` string — Table name for SQL-based data assets
      - `hostName` string — Host server name for on-premises database connections
      - `testConnectionDatasetName` string — Connection Dataset name for Google Big Quey type of data asset
      - `testConnectionSchemaName` string — Connection Schema name for Google Big Query type of data asset
      - `projectId` string — Project ID for Google Big Query type of data asset
      - `isDQAsset` boolean — Flag indicating if the asset is a Data Quality asset
    - `assetScopedMetadata` ScopedAssetMetadata, required — Scoped asset metadata configuration linked to a specific data asset.
      - `id` string — Unique identifier for the scoped asset metadata entity.
      - `description` string, required — Descriptive text providing details about the scoped asset metadata.
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `runtime` ScopedAssetMetadataRuntime — Runtime configuration options for a scoped asset metadata entity.
        - `isErrorRowRequired` boolean, required — Indicates whether error row details should be captured.
        - `errorRowWriteFormat` string — Specifies the format in which error rows are written (e.g., CSV, Parquet).
      - `favouriteColumnPaths` string[], required — List of favorite column paths selected for quick access or monitoring.
      - `createdAt` string, date-time — Timestamp when this metadata was created.
      - `lastModifiedAt` string, date-time — Timestamp when this metadata was last modified.
      - `createdBy` string — Identifier of the user who created this metadata.
      - `lastModifiedBy` string — Identifier of the user who last modified this metadata.
      - `ETag` string — Entity tag used for concurrency control and version validation.
    - `scoreSnapshot` ScoreSnapshot, required — Comprehensive score snapshot with business domain, data product, asset scoring, and validation results
      - `businessDomainId` string, required — Business domain identifier
      - `dataProductId` string, required — Data product identifier
      - `assetId` string, required — Asset identifier
      - `assetScore` number, double, required — Overall score for the asset
      - `originAssetId` string, required — Origin asset identifier
      - `isStandaloneAsset` boolean, required — Is the asset standalone
      - `rules` ScoredRule[], required — Rules with their scores and validation results
        - `id` string — Rule identifier
        - `score` number, double — Score for the rule
        - `name` string — Name of the rule
        - `description` string — Description of the rule
        - `type` string — Type of the rule
        - `status` string — Status of the rule
        - `columns` unknown[] — Columns associated with the rule
          - unknown
        - `totalRows` integer — Total number of rows processed
        - `failedRows` integer — Number of failed rows
        - `passedRows` integer — Number of passed rows
        - `emptyRows` integer — Number of empty rows
        - `miscastRows` integer — Number of miscast rows
        - `queryExecuted` string — The query which has been executed
        - `dimension` string — Dimension of the rule
        - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `typeProperties` TypeProperties — Type-specific configuration properties for data quality rules.
          - `column` Column — Column definition for dataset validation and quality checks
            - `type` string — Column data type or classification
            - `value` string — Column name or identifier
          - `columns` Column[] — List of columns for multi-column or relational rules (e.g., Duplicate, CustomTruth).
            - `type` string — Column data type or classification
            - `value` string — Column name or identifier
          - `pattern` string — Regex or pattern-based validation logic for format rules.
          - `condition` string — Main logical condition or expression defining validation criteria.
          - `filterCriteria` string — Optional filter condition to limit rows that are validated by this rule.
          - `emptyCriteria` string — Optional condition defining when a field or column is considered empty.
        - `lastModifiedAt` string, date-time — Last modification timestamp
        - `lastModifiedBy` string — Last modifier user ID
        - `createdBy` string — Creator user ID
        - `createdAt` string, date-time — Creation timestamp
      - `job` SnapshotJob, required — Job information associated with a score snapshot
        - `jobId` string — Job identifier
        - `businessDomainId` string — Business domain identifier
    - `globalRules` RuleEntity[], required — Global rules applied to the asset
      - `name` string, required — Descriptive name of the rule
      - `description` string — Detailed description of rule validation and business purpose
      - `type` string, required — Rule type classification
      - `status` string, required — Current execution status
      - `typeProperties` TypeProperties — Type-specific configuration properties for data quality rules.
        - `column` Column — Column definition for dataset validation and quality checks
          - `type` string — Column data type or classification
          - `value` string — Column name or identifier
        - `columns` Column[] — List of columns for multi-column or relational rules (e.g., Duplicate, CustomTruth).
          - `type` string — Column data type or classification
          - `value` string — Column name or identifier
        - `pattern` string — Regex or pattern-based validation logic for format rules.
        - `condition` string — Main logical condition or expression defining validation criteria.
        - `filterCriteria` string — Optional filter condition to limit rows that are validated by this rule.
        - `emptyCriteria` string — Optional condition defining when a field or column is considered empty.
      - `id` string, required — Unique rule identifier
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `score` number, double — Quality score (0.0 to 1.0)
      - `dimension` string — Optional business dimension or classification
      - `createdAt` string, date-time — Timestamp when this rule was created
      - `lastModifiedAt` string, date-time — Timestamp when this rule was last modified
      - `createdBy` string — User identifier for the creator of the rule
      - `lastModifiedBy` string — User identifier for the last modifier of the rule

## Response `201`

The request has succeeded and a new resource has been created as a result.

- BulkAssetMetadataRequestResponse — Response containing bulk asset metadata with pagination support
  - `continuationToken` string — Continuation token for pagination. Null when no more results are available.
  - `metadata` BulkAssetMetadataEntry[], required — Array of metadata entries (up to 10 per response)
    - `assetMetadata` AssetMetadata, required — Unified metadata observer for monitoring data assets across platforms
      - `id` string, required — Unique identifier of the asset metadata observer
      - `name` string — Display name of the asset metadata observer
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `createdAt` string, date-time — Creation timestamp (UTC)
      - `createdBy` string — Identity of the creating user
      - `lastModifiedAt` string, date-time — Last modification timestamp (UTC)
      - `lastModifiedBy` string — Identity of the last modifying user
      - `isDeleted` boolean — Soft deletion flag
      - `ETag` string — Entity tag for concurrency control
      - `type` string, required — Data source type classification
      - `typeProperties` AssetMetadataCommonProperties — Shared metadata properties across all data asset types
        - `inputDatasets` unknown[] — Input dataset definitions and schemas
          - unknown
        - `projection` unknown
      - `location` Location[] — Physical storage locations for file-based assets
        - `type` string, required — Storage type classification
        - `typeProperties` LocationTypeProperties, required — Storage-specific configuration properties for different location types
          - `fileSystem` string — File system or container name
          - `folderPath` string — Hierarchical path within the storage location
          - `accountName` string — Storage account name or endpoint identifier
          - `region` string — Geographic region or environment location
      - `format` string — Data format specification for structured assets
      - `schemaName` string — Database schema name for SQL-based assets
      - `tableName` string — Table name for SQL-based data assets
      - `hostName` string — Host server name for on-premises database connections
      - `testConnectionDatasetName` string — Connection Dataset name for Google Big Quey type of data asset
      - `testConnectionSchemaName` string — Connection Schema name for Google Big Query type of data asset
      - `projectId` string — Project ID for Google Big Query type of data asset
      - `isDQAsset` boolean — Flag indicating if the asset is a Data Quality asset
    - `assetScopedMetadata` ScopedAssetMetadata, required — Scoped asset metadata configuration linked to a specific data asset.
      - `id` string — Unique identifier for the scoped asset metadata entity.
      - `description` string, required — Descriptive text providing details about the scoped asset metadata.
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `runtime` ScopedAssetMetadataRuntime — Runtime configuration options for a scoped asset metadata entity.
        - `isErrorRowRequired` boolean, required — Indicates whether error row details should be captured.
        - `errorRowWriteFormat` string — Specifies the format in which error rows are written (e.g., CSV, Parquet).
      - `favouriteColumnPaths` string[], required — List of favorite column paths selected for quick access or monitoring.
      - `createdAt` string, date-time — Timestamp when this metadata was created.
      - `lastModifiedAt` string, date-time — Timestamp when this metadata was last modified.
      - `createdBy` string — Identifier of the user who created this metadata.
      - `lastModifiedBy` string — Identifier of the user who last modified this metadata.
      - `ETag` string — Entity tag used for concurrency control and version validation.
    - `scoreSnapshot` ScoreSnapshot, required — Comprehensive score snapshot with business domain, data product, asset scoring, and validation results
      - `businessDomainId` string, required — Business domain identifier
      - `dataProductId` string, required — Data product identifier
      - `assetId` string, required — Asset identifier
      - `assetScore` number, double, required — Overall score for the asset
      - `originAssetId` string, required — Origin asset identifier
      - `isStandaloneAsset` boolean, required — Is the asset standalone
      - `rules` ScoredRule[], required — Rules with their scores and validation results
        - `id` string — Rule identifier
        - `score` number, double — Score for the rule
        - `name` string — Name of the rule
        - `description` string — Description of the rule
        - `type` string — Type of the rule
        - `status` string — Status of the rule
        - `columns` unknown[] — Columns associated with the rule
          - unknown
        - `totalRows` integer — Total number of rows processed
        - `failedRows` integer — Number of failed rows
        - `passedRows` integer — Number of passed rows
        - `emptyRows` integer — Number of empty rows
        - `miscastRows` integer — Number of miscast rows
        - `queryExecuted` string — The query which has been executed
        - `dimension` string — Dimension of the rule
        - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
          - `type` string — Type classification of the referenced entity
          - `referenceId` string — Unique identifier of the referenced entity
        - `typeProperties` TypeProperties — Type-specific configuration properties for data quality rules.
          - `column` Column — Column definition for dataset validation and quality checks
            - `type` string — Column data type or classification
            - `value` string — Column name or identifier
          - `columns` Column[] — List of columns for multi-column or relational rules (e.g., Duplicate, CustomTruth).
            - `type` string — Column data type or classification
            - `value` string — Column name or identifier
          - `pattern` string — Regex or pattern-based validation logic for format rules.
          - `condition` string — Main logical condition or expression defining validation criteria.
          - `filterCriteria` string — Optional filter condition to limit rows that are validated by this rule.
          - `emptyCriteria` string — Optional condition defining when a field or column is considered empty.
        - `lastModifiedAt` string, date-time — Last modification timestamp
        - `lastModifiedBy` string — Last modifier user ID
        - `createdBy` string — Creator user ID
        - `createdAt` string, date-time — Creation timestamp
      - `job` SnapshotJob, required — Job information associated with a score snapshot
        - `jobId` string — Job identifier
        - `businessDomainId` string — Business domain identifier
    - `globalRules` RuleEntity[], required — Global rules applied to the asset
      - `name` string, required — Descriptive name of the rule
      - `description` string — Detailed description of rule validation and business purpose
      - `type` string, required — Rule type classification
      - `status` string, required — Current execution status
      - `typeProperties` TypeProperties — Type-specific configuration properties for data quality rules.
        - `column` Column — Column definition for dataset validation and quality checks
          - `type` string — Column data type or classification
          - `value` string — Column name or identifier
        - `columns` Column[] — List of columns for multi-column or relational rules (e.g., Duplicate, CustomTruth).
          - `type` string — Column data type or classification
          - `value` string — Column name or identifier
        - `pattern` string — Regex or pattern-based validation logic for format rules.
        - `condition` string — Main logical condition or expression defining validation criteria.
        - `filterCriteria` string — Optional filter condition to limit rows that are validated by this rule.
        - `emptyCriteria` string — Optional condition defining when a field or column is considered empty.
      - `id` string, required — Unique rule identifier
      - `businessDomain` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataProduct` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `dataAsset` Reference — Reference to entities in the data governance hierarchy for relationship establishment
        - `type` string — Type classification of the referenced entity
        - `referenceId` string — Unique identifier of the referenced entity
      - `score` number, double — Quality score (0.0 to 1.0)
      - `dimension` string — Optional business dimension or classification
      - `createdAt` string, date-time — Timestamp when this rule was created
      - `lastModifiedAt` string, date-time — Timestamp when this rule was last modified
      - `createdBy` string — User identifier for the creator of the rule
      - `lastModifiedBy` string — User identifier for the last modifier of the rule

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/purviewdatagovernace-azure-analaytics-purview-dataquality.md) · [All operations](https://skmtc.net/azure/apis/purviewdatagovernace-azure-analaytics-purview-dataquality/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purviewdatagovernace-azure-analaytics-purview-dataquality/versions/19e792d8178b/schema)