# Bulk Update Atomic Creatives

Update multiple atomic creatives

Endpoint: POST /bulk_update/atomic_creatives
Version: 3.0.1807
Security: Auth0

## Query parameters:

  - `extended` (boolean)
    Get extended properties in response

## Request fields (application/json):

  - `atomic_creatives` (object)

  - `atomic_creatives.create` (array)

  - `atomic_creatives.create.width` (integer, required)
    Example: 80

  - `atomic_creatives.create.name` (string, required)

  - `atomic_creatives.create.height` (integer, required)
    Example: 90

  - `atomic_creatives.create.creative_import_file_id` (integer)
    Example: 5

  - `atomic_creatives.create.file_type` (string)
    Enum: "swf", "gif", "html5", "jpg", "jpeg", "tiff", "tif", "png", "unknown", "vast"

  - `atomic_creatives.create.is_multi_creative` (boolean)

  - `atomic_creatives.create.has_sound` (boolean)

  - `atomic_creatives.create.rich_media` (boolean)

  - `atomic_creatives.create.rich_media_provider` (string)

  - `atomic_creatives.create.built` (boolean)

  - `atomic_creatives.create.build_date` (string)

  - `atomic_creatives.create.build_errors` (string)

  - `atomic_creatives.create.external_identifier` (string)

  - `atomic_creatives.create.expand` (string)

  - `atomic_creatives.create.expansion_trigger` (string)
    Enum: "AUTOMATIC", "MOUSEOVER", "CLICK"

  - `atomic_creatives.create.tpas_ad_tag` (string)

  - `atomic_creatives.create.edited_tag` (string)

  - `atomic_creatives.create.click_through_url` (string,null)

  - `atomic_creatives.create.concept_id` (integer,null)
    Example: 7

  - `atomic_creatives.create.status` (boolean)

  - `atomic_creatives.create.archived` (boolean)

  - `atomic_creatives.create.is_mraid` (boolean)

  - `atomic_creatives.create.is_https` (boolean)

  - `atomic_creatives.create.t1as` (boolean)

  - `atomic_creatives.create.start_date` (string,null)

  - `atomic_creatives.create.end_date` (string,null)

  - `atomic_creatives.create.vast_version` (number,null)

  - `atomic_creatives.create.is_audio` (boolean,null)

  - `atomic_creatives.create.expansion_direction` (string)

  - `atomic_creatives.create.media_type` (string)
    Enum: "display", "video", "mobile"

  - `atomic_creatives.create.ad_server_type` (string)
    Enum: "ADOCADO", "ATLAS", "DART", "DOUBLECLICK", "EYEWONDER", "FLASHTALKING", "MEDIAFORGE", "MEDIAMIND", "MEDIAPLEX", "OTHER", "POINTROLL", "SIZMEK", "TERMINALONE", "TRUEFFECT", "YIELD_MANAGER"

  - `atomic_creatives.create.ad_format` (string)
    Enum: "DISPLAY", "MOBILE", "EXPANDABLE", "FBX", "COMPONENT"

  - `atomic_creatives.create.tpas_ad_tag_name` (string)

  - `atomic_creatives.create.click_url` (string,null)

  - `atomic_creatives.create.sizmek_tag_status` (string)

  - `atomic_creatives.create.sizmek_creative_status` (string)

  - `atomic_creatives.create.advertiser_id` (integer, required)

  - `atomic_creatives.create.tag` (string)

  - `atomic_creatives.create.tag_type` (string)
    Enum: "IFRAME_SCRIPT_NOSCRIPT", "IFRAME_SCRIPT", "IFRAME_NOSCRIPT", "IFRAME_IMG", "SCRIPT_NOSCRIPT", "SCRIPT", "NOSCRIPT", "IFRAME", "IMG", "VIDEO"

  - `atomic_creatives.create.vendor_ids` (array)
    Example: [3,56]

  - `atomic_creatives.update` (array)

  - `atomic_creatives.update.id` (integer)
    Example: 11

  - `atomic_creatives.update.name` (string)

  - `atomic_creatives.update.version` (integer)
    Example: 3

  - `atomic_creatives.update.external_identifier` (string,null)

  - `atomic_creatives.update.width` (integer)
    Example: 80

  - `atomic_creatives.update.height` (integer)
    Example: 90

  - `atomic_creatives.update.concept_id` (integer,null)
    Example: 33

  - `atomic_creatives.update.status` (boolean)

  - `atomic_creatives.update.archived` (boolean)

  - `atomic_creatives.update.is_mraid` (boolean)

  - `atomic_creatives.update.is_https` (boolean)

  - `atomic_creatives.update.t1as` (boolean)

  - `atomic_creatives.update.start_date` (string,null)

  - `atomic_creatives.update.end_date` (string,null)

  - `atomic_creatives.update.vast_version` (number,null)

  - `atomic_creatives.update.is_audio` (boolean,null)

  - `atomic_creatives.update.expansion_direction` (string)

  - `atomic_creatives.update.expansion_trigger` (string)
    Enum: same as `atomic_creatives.create.expansion_trigger` (3 values)

  - `atomic_creatives.update.media_type` (string)
    Enum: same as `atomic_creatives.create.media_type` (3 values)

  - `atomic_creatives.update.ad_server_type` (string)
    Enum: same as `atomic_creatives.create.ad_server_type` (15 values)

  - `atomic_creatives.update.ad_format` (string)
    Enum: same as `atomic_creatives.create.ad_format` (5 values)

  - `atomic_creatives.update.tpas_ad_tag` (string)

  - `atomic_creatives.update.tpas_ad_tag_name` (string)

  - `atomic_creatives.update.click_through_url` (string,null)

  - `atomic_creatives.update.click_url` (string,null)

  - `atomic_creatives.update.edited_tag` (string)

  - `atomic_creatives.update.tag` (string,null)

  - `atomic_creatives.update.tag_type` (string)
    Enum: same as `atomic_creatives.create.tag_type` (10 values)

  - `atomic_creatives.update.vendor_ids` (array)
    Example: [3,56]

## Response 200 fields (application/json):

  - `data` (array) — one of:
    - atomic_creative_response:
      - `id` (integer, required)
      - `version` (integer, required)
      - `entity_type` (string, required)
      - `advertiser_id` (integer, required)
      - `concept_id` (integer)
      - `concept_name` (string)
      - `name` (string, required)
      - `width` (integer, required)
      - `height` (integer, required)
      - `creative_import_file_id` (integer)
      - `file_type` (string, required)
      - `is_https` (boolean, required)
      - `is_multi_creative` (boolean, required)
      - `has_sound` (boolean, required)
      - `rich_media` (boolean, required)
      - `rich_media_provider` (string)
      - `status` (boolean)
      - `archived` (boolean)
      - `built` (boolean, required)
      - `build_date` (string)
      - `built_by_user_id` (integer,null)
      - `build_errors` (string)
      - `created_on` (string, required)
      - `last_modified` (string, required)
      - `external_identifier` (string)
      - `tpas_ad_tag_name` (string, required)
      - `updated_on` (string, required)
      - `expand` (string)
      - `click_url` (string)
      - `ad_format` (string, required)
      - `expansion_direction` (string, required)
      - `expansion_trigger` (string, required)
        Enum: same as `atomic_creatives.create.expansion_trigger` (3 values)
      - `ad_server_type` (string)
      - `t1as` (boolean, required)
      - `tpas_ad_tag` (string)
      - `edited_tag` (string)
      - `click_through_url` (string)
      - `rejected_reason` (string)
      - `approval_status` (string, required)
      - `start_date` (string)
      - `end_date` (string)
      - `media_type` (string, required)
      - `is_mraid` (boolean, required)
      - `vast_version` (number,null)
      - `sizmek_tag_status` (string, required)
      - `sizmek_creative_status` (string, required)
      - `last_payload_modified` (string)
      - `is_audio` (boolean)
      - `tag` (string)
      - `tag_type` (string)
    - atomic_creative_response_extended:
      - `id` (integer, required)
      - `version` (integer, required)
      - `entity_type` (string, required)
      - `advertiser_id` (integer, required)
      - `advertiser_name` (string)
        available only when extended
      - `concept_id` (integer)
      - `concept_name` (string)
      - `name` (string, required)
      - `width` (integer, required)
      - `height` (integer, required)
      - `creative_import_file_id` (integer)
      - `file_type` (string, required)
      - `is_https` (boolean, required)
      - `is_multi_creative` (boolean, required)
      - `has_sound` (boolean, required)
      - `rich_media` (boolean, required)
      - `rich_media_provider` (string)
      - `status` (boolean)
      - `archived` (boolean)
      - `built` (boolean, required)
      - `build_date` (string)
      - `built_by_user_id` (integer,null, required)
      - `build_errors` (string)
      - `created_on` (string, required)
      - `last_modified` (string, required)
      - `external_identifier` (string)
      - `tpas_ad_tag_name` (string, required)
      - `updated_on` (string, required)
      - `expand` (string)
      - `click_url` (string)
      - `ad_format` (string, required)
      - `expansion_direction` (string, required)
      - `expansion_trigger` (string, required)
        Enum: same as `atomic_creatives.create.expansion_trigger` (3 values)
      - `ad_server_type` (string)
      - `t1as` (boolean, required)
      - `tpas_ad_tag` (string)
      - `edited_tag` (string)
      - `click_through_url` (string)
      - `rejected_reason` (string)
      - `approval_status` (string, required)
      - `start_date` (string)
      - `end_date` (string)
      - `media_type` (string, required)
      - `is_mraid` (boolean, required)
      - `vast_version` (number,null)
      - `sizmek_tag_status` (string, required)
      - `sizmek_creative_status` (string, required)
      - `last_payload_modified` (string)
      - `is_audio` (boolean)
      - `tag` (string)
      - `tag_type` (string)
      - `targeted_strategies` (object)
        available only when extended
      - `targeted_strategies.count` (integer)
      - `targeted_strategies.strategies_list` (array)
      - `atomic_creative_ssl_validators` (object)
        available only when extended
      - `atomic_creative_ssl_validators.is_https` (string)
      - `atomic_creative_ssl_validators.notify_state` (string)
      - `atomic_creative_ssl_validators.ignored` (string)
      - `atomic_creative_ssl_validators.ksize` (integer)
      - `vendors` (array)
        available only when extended
      - `vendors.id` (integer)
      - `vendors.name` (string)
      - `vendors.adx_approved` (boolean)
      - `vendors.adx_declaration_required` (boolean)
      - `vendors.mm_contract_available` (boolean)
      - `vendors.is_eligible` (boolean)
      - `vendors.adx_ssl_approved` (boolean)
      - `vendors.adx_video_ssl_approved` (boolean)
      - `vendors.adx_video_approved` (boolean)
      - `vendors.auto_tag_display` (boolean)
      - `vendors.set_by` (string)
      - `vendors.detect_domains` (array)
      - `creative_assets` (array)
        available only when extended
      - `creative_assets.id` (integer)
      - `creative_assets.name` (string)
      - `creative_assets.version` (integer)
      - `creative_assets.creative_id` (integer)
      - `creative_assets.primary_asset_id` (integer)
      - `creative_assets.created_on` (string)
      - `creative_assets.updated_on` (string)
      - `creative_assets.file_name` (string)
      - `creative_assets.file_role` (string)
      - `creative_assets.file_type` (string)
      - `creative_assets.file_storage_path` (string)
      - `creative_assets.file_size` (integer)
      - `creative_assets.media_version` (number)
      - `creative_assets.width` (integer)
      - `creative_assets.height` (integer)
      - `creative_assets.note` (string)
      - `inner_tag` (string)
        available only when extended. Contains the original inner tag content for HTML5 creatives.

  - `meta` (object)

  - `meta.status` (string, required)
    The status of the response, indicating success or failure.
    Example: "success"

  - `meta.count` (integer, required)
    The number of items returned in the current response.
    Example: 10

  - `meta.total_count` (integer)
    The total number of items available in the dataset.
    Example: 100

  - `meta.offset` (integer)
    The offset from the start of the dataset, used for pagination.

  - `meta.next_page` (string)
    The URL to fetch the next page of results.

  - `meta.prev_page` (string)
    The URL to fetch the previous page of results.

  - `errors` (array)

  - `errors.id` (integer)

  - `errors.action` (string)

  - `errors.entity_type` (string)

  - `errors.index` (integer)

  - `errors.errors` (array)

  - `errors.errors.id` (integer)

  - `errors.errors.code` (string)

  - `errors.errors.field` (string)

  - `errors.errors.message` (string)

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)