--- title: "Update an atomic creative" method: POST path: "/atomic_creatives/{atomic_creative_id}" tags: ["Atomic Creatives"] --- # Update an atomic creative `POST /atomic_creatives/{atomic_creative_id}` ## Request - Base URL: `https://api.mediamath.com/api/v3.0` - URL: `https://api.mediamath.com/api/v3.0/atomic_creatives/{atomic_creative_id}` - Auth: OAuth 2 - Authorization code: `https://auth.mediamath.com/authorize` - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services` - TypeScript: (a function with typed inputs; its response is checked against the schema) Update an atomic creative by ID ## Path parameters - `atomic_creative_id` integer, required ## Query parameters - `extended` boolean ## Request body - object - `name` string - `version` integer - `external_identifier` string, nullable - `width` integer - `height` integer - `concept_id` integer, nullable - `status` boolean - `archived` boolean - `is_mraid` boolean - `is_https` boolean - `t1as` boolean - `start_date` string, date-time, nullable - `end_date` string, date-time, nullable - `vast_version` number, float, nullable - `is_audio` boolean, nullable - `expansion_direction` string - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK' - `media_type` 'display' | 'video' | 'mobile' - `ad_server_type` 'ADOCADO' | 'ATLAS' | 'DART' | 'DOUBLECLICK' | 'EYEWONDER' | 'FLASHTALKING' | 'MEDIAFORGE' | 'MEDIAMIND' | 'MEDIAPLEX' | 'OTHER' | 'POINTROLL' | 'SIZMEK' | 'TERMINALONE' | 'TRUEFFECT' | 'YIELD_MANAGER' - `ad_format` 'DISPLAY' | 'MOBILE' | 'EXPANDABLE' | 'FBX' | 'COMPONENT' - `tpas_ad_tag` string - `tpas_ad_tag_name` string - `click_through_url` string, uri, nullable - `click_url` string, uri, nullable - `edited_tag` string - `tag` string, nullable - `built_by_user_id` integer - `tag_type` 'IFRAME_SCRIPT_NOSCRIPT' | 'IFRAME_SCRIPT' | 'IFRAME_NOSCRIPT' | 'IFRAME_IMG' | 'SCRIPT_NOSCRIPT' | 'SCRIPT' | 'NOSCRIPT' | 'IFRAME' | 'IMG' | 'VIDEO' - `vendor_ids` integer[] ## Response `200` Atomic creative response - object - `data` union - AtomicCreativeResponse - `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, nullable - `build_errors` string - `created_on` string, date-time, required - `last_modified` string, required - `external_identifier` string - `tpas_ad_tag_name` string, required - `updated_on` string, date-time, required - `expand` string - `click_url` string - `ad_format` string, required - `expansion_direction` string, required - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK', required - `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, float, nullable - `sizmek_tag_status` string, required - `sizmek_creative_status` string, required - `last_payload_modified` string - `is_audio` boolean - `tag` string - `tag_type` string - AtomicCreativeResponseExtended - `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, nullable, required - `build_errors` string - `created_on` string, date-time, required - `last_modified` string, required - `external_identifier` string - `tpas_ad_tag_name` string, required - `updated_on` string, date-time, required - `expand` string - `click_url` string - `ad_format` string, required - `expansion_direction` string, required - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK', required - `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, float, nullable - `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 - `count` integer - `strategies_list` integer[] - `atomic_creative_ssl_validators` object: available only when extended - `is_https` string - `notify_state` string - `ignored` string - `ksize` integer - `vendors` object[]: available only when extended - `id` integer - `name` string - `adx_approved` boolean - `adx_declaration_required` boolean - `mm_contract_available` boolean - `is_eligible` boolean - `adx_ssl_approved` boolean - `adx_video_ssl_approved` boolean - `adx_video_approved` boolean - `auto_tag_display` boolean - `set_by` string - `detect_domains` string[] - `creative_assets` object[]: available only when extended - `id` integer - `name` string - `version` integer - `creative_id` integer - `primary_asset_id` integer - `created_on` string, date-time - `updated_on` string, date-time - `file_name` string - `file_role` string - `file_type` string - `file_storage_path` string - `file_size` integer - `media_version` number, float - `width` integer - `height` integer - `note` string - `inner_tag` string: available only when extended. Contains the original inner tag content for HTML5 creatives. - `meta` SingleMetadata - `status` string, required ## Other responses - `400`: Error response - `401`: Error response - `403`: Error response - `404`: Error response - `409`: Error response --- [API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)