Mirror public docs markdown from braze.com/docs (2026-08-11) (#74)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

changes/2026-08-11.md

@@ -0,0 +1,154 @@
+# Daily docs markdown sync - 2026-08-11
+
+## Summary
+- Source: https://www.braze.com/docs/sitemap.xml
+- Changed files: 147
+
+## Changes
+- M `docs/API/api_campaigns/index.md`
+- M `docs/API/endpoints/apps/post_update_push_credential/index.md`
+- M `docs/API/endpoints/catalogs/catalog_fields/asynchronous/delete_catalog_field/index.md`
+- M `docs/API/endpoints/catalogs/catalog_fields/asynchronous/post_create_catalog_fields/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/asynchronous/delete_catalog_items_bulk/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/asynchronous/patch_catalog_items_bulk/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/asynchronous/post_create_catalog_items_bulk/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/asynchronous/put_update_catalog_items/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/delete_catalog_item/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/get_catalog_item_details/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/get_catalog_items_details_bulk/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/patch_catalog_item/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/post_create_catalog_item/index.md`
+- M `docs/API/endpoints/catalogs/catalog_items/synchronous/put_update_catalog_item/index.md`
+- M `docs/API/endpoints/catalogs/catalog_management/synchronous/delete_catalog/index.md`
+- M `docs/API/endpoints/catalogs/catalog_management/synchronous/get_list_catalogs/index.md`
+- M `docs/API/endpoints/catalogs/catalog_management/synchronous/post_create_catalog/index.md`
+- M `docs/API/endpoints/catalogs/catalog_selections/asynchronous/delete_catalog_selection/index.md`
+- M `docs/API/endpoints/catalogs/catalog_selections/asynchronous/post_create_catalog_selections/index.md`
+- M `docs/API/endpoints/cdi/get_integration_list/index.md`
+- M `docs/API/endpoints/cdi/get_job_sync_status/index.md`
+- M `docs/API/endpoints/cdi/post_job_sync/index.md`
+- M `docs/API/endpoints/email/get_list_hard_bounces/index.md`
+- M `docs/API/endpoints/email/get_query_unsubscribed_email_addresses/index.md`
+- M `docs/API/endpoints/email/post_blacklist/index.md`
+- M `docs/API/endpoints/email/post_blocklist/index.md`
+- M `docs/API/endpoints/email/post_email_subscription_status/index.md`
+- M `docs/API/endpoints/email/post_remove_hard_bounces/index.md`
+- M `docs/API/endpoints/email/post_remove_spam/index.md`
+- M `docs/API/endpoints/export/campaigns/get_campaign_analytics/index.md`
+- M `docs/API/endpoints/export/campaigns/get_campaign_details/index.md`
+- M `docs/API/endpoints/export/campaigns/get_campaigns/index.md`
+- M `docs/API/endpoints/export/campaigns/get_send_analytics/index.md`
+- M `docs/API/endpoints/export/canvas/get_canvas_analytics/index.md`
+- M `docs/API/endpoints/export/canvas/get_canvas_analytics_summary/index.md`
+- M `docs/API/endpoints/export/canvas/get_canvas_details/index.md`
+- M `docs/API/endpoints/export/canvas/get_canvases/index.md`
+- M `docs/API/endpoints/export/custom_attributes/get_custom_attributes/index.md`
+- M `docs/API/endpoints/export/custom_events/get_custom_events/index.md`
+- M `docs/API/endpoints/export/custom_events/get_custom_events_analytics/index.md`
+- M `docs/API/endpoints/export/custom_events/get_custom_events_data/index.md`
+- M `docs/API/endpoints/export/kpi/get_kpi_daily_new_users_date/index.md`
+- M `docs/API/endpoints/export/kpi/get_kpi_dau_date/index.md`
+- M `docs/API/endpoints/export/kpi/get_kpi_mau_30_days/index.md`
+- M `docs/API/endpoints/export/kpi/get_kpi_uninstalls_date/index.md`
+- M `docs/API/endpoints/export/purchases/get_list_product_id/index.md`
+- M `docs/API/endpoints/export/purchases/get_number_of_purchases/index.md`
+- M `docs/API/endpoints/export/purchases/get_revenue_series/index.md`
+- M `docs/API/endpoints/export/segments/get_segment/index.md`
+- M `docs/API/endpoints/export/segments/get_segment_analytics/index.md`
+- M `docs/API/endpoints/export/segments/get_segment_details/index.md`
+- M `docs/API/endpoints/export/segments/post_cancel_export/index.md`
+- M `docs/API/endpoints/export/sessions/get_sessions_analytics/index.md`
+- M `docs/API/endpoints/export/user_data/post_users_global_control_group/index.md`
+- M `docs/API/endpoints/export/user_data/post_users_identifier/index.md`
+- M `docs/API/endpoints/export/user_data/post_users_segment/index.md`
+- M `docs/API/endpoints/media_library/manage_assets/create/index.md`
+- M `docs/API/endpoints/media_library/manage_assets/replace_file/index.md`
+- M `docs/API/endpoints/messaging/duplicate_messages/post_duplicate_campaigns/index.md`
+- M `docs/API/endpoints/messaging/duplicate_messages/post_duplicate_canvases/index.md`
+- M `docs/API/endpoints/messaging/live_activity/start/index.md`
+- M `docs/API/endpoints/messaging/live_activity/update/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/get_messages_scheduled/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_delete_scheduled_messages/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_delete_scheduled_triggered_canvases/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_delete_scheduled_triggered_messages/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_schedule_messages/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_schedule_triggered_campaigns/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_schedule_triggered_canvases/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_update_scheduled_messages/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_update_scheduled_triggered_campaigns/index.md`
+- M `docs/API/endpoints/messaging/schedule_messages/post_update_scheduled_triggered_canvases/index.md`
+- M `docs/API/endpoints/messaging/send_messages/post_create_send_ids/index.md`
+- M `docs/API/endpoints/messaging/send_messages/post_send_messages/index.md`
+- M `docs/API/endpoints/messaging/send_messages/post_send_transactional_message/index.md`
+- M `docs/API/endpoints/messaging/send_messages/post_send_triggered_campaigns/index.md`
+- M `docs/API/endpoints/messaging/send_messages/post_send_triggered_canvases/index.md`
+- M `docs/API/endpoints/preference_center/get_create_url_preference_center/index.md`
+- M `docs/API/endpoints/preference_center/get_list_preference_center/index.md`
+- M `docs/API/endpoints/preference_center/get_view_details_preference_center/index.md`
+- M `docs/API/endpoints/preference_center/post_create_preference_center/index.md`
+- M `docs/API/endpoints/preference_center/put_update_preference_center/index.md`
+- M `docs/API/endpoints/scim/delete_existing_dashboard_user/index.md`
+- M `docs/API/endpoints/scim/get_search_existing_dashboard_user/index.md`
+- M `docs/API/endpoints/scim/get_see_user_account_information/index.md`
+- M `docs/API/endpoints/scim/post_create_user_account/index.md`
+- M `docs/API/endpoints/scim/put_update_existing_user_account/index.md`
+- M `docs/API/endpoints/sdk_authentication/delete_sdk_authentication_key/index.md`
+- M `docs/API/endpoints/sdk_authentication/get_sdk_authentication_keys/index.md`
+- M `docs/API/endpoints/sdk_authentication/post_create_sdk_authentication_key/index.md`
+- M `docs/API/endpoints/sdk_authentication/put_primary_sdk_authentication_key/index.md`
+- M `docs/API/endpoints/sms/get_query_invalid_numbers/index.md`
+- M `docs/API/endpoints/sms/post_remove_invalid_numbers/index.md`
+- M `docs/API/endpoints/subscription_groups/get_list_user_subscription_group_status/index.md`
+- M `docs/API/endpoints/subscription_groups/get_list_user_subscription_groups/index.md`
+- M `docs/API/endpoints/subscription_groups/post_update_user_subscription_group_status/index.md`
+- M `docs/API/endpoints/subscription_groups/post_update_user_subscription_group_status_v2/index.md`
+- M `docs/API/endpoints/templates/content_blocks_templates/get_list_email_content_blocks/index.md`
+- M `docs/API/endpoints/templates/content_blocks_templates/get_see_email_content_blocks_information/index.md`
+- M `docs/API/endpoints/templates/content_blocks_templates/post_create_email_content_block/index.md`
+- M `docs/API/endpoints/templates/content_blocks_templates/post_update_content_block/index.md`
+- M `docs/API/endpoints/templates/email_templates/get_list_email_templates/index.md`
+- M `docs/API/endpoints/templates/email_templates/get_see_email_template_information/index.md`
+- M `docs/API/endpoints/templates/email_templates/post_create_email_template/index.md`
+- M `docs/API/endpoints/templates/email_templates/post_update_email_template/index.md`
+- M `docs/API/endpoints/translations/campaigns/get_source_campaign/index.md`
+- M `docs/API/endpoints/translations/campaigns/get_translation_campaign/index.md`
+- M `docs/API/endpoints/translations/campaigns/put_update_translation_campaign/index.md`
+- M `docs/API/endpoints/translations/canvas/get_source_canvas/index.md`
+- M `docs/API/endpoints/translations/canvas/get_translation_canvas/index.md`
+- M `docs/API/endpoints/translations/canvas/put_update_translation_canvas/index.md`
+- M `docs/API/endpoints/translations/content_blocks/get_source_content_block/index.md`
+- M `docs/API/endpoints/translations/content_blocks/get_translation_content_block/index.md`
+- M `docs/API/endpoints/translations/content_blocks/put_update_translation_content_block/index.md`
+- M `docs/API/endpoints/translations/email_templates/get_view_source_template/index.md`
+- M `docs/API/endpoints/translations/email_templates/get_view_translation_locale_template/index.md`
+- M `docs/API/endpoints/translations/email_templates/get_view_translation_template/index.md`
+- M `docs/API/endpoints/translations/email_templates/put_update_template/index.md`
+- M `docs/API/endpoints/user_data/external_id_migration/post_external_ids_remove/index.md`
+- M `docs/API/endpoints/user_data/external_id_migration/post_external_ids_rename/index.md`
+- M `docs/API/endpoints/user_data/post_user_alias/index.md`
+- M `docs/API/endpoints/user_data/post_user_delete/index.md`
+- M `docs/API/endpoints/user_data/post_user_identify/index.md`
+- M `docs/API/endpoints/user_data/post_user_track/index.md`
+- M `docs/API/endpoints/user_data/post_user_track_bulk/index.md`
+- M `docs/API/endpoints/user_data/post_user_track_synchronous/index.md`
+- M `docs/API/endpoints/user_data/post_users_alias_update/index.md`
+- M `docs/API/endpoints/user_data/post_users_merge/index.md`
+- M `docs/Developer Guide/changelogs/index.md`
+- M `docs/Developer Guide/getting_started/platform_overview/index.md`
+- M `docs/User Guide/administer/global/workspace_settings/email_preferences/bot_filtering/index.md`
+- M `docs/User Guide/analytics/dashboards/dashboard_builder/diagnostics_dashboard/index.md`
+- M `docs/User Guide/analytics/metrics_glossary/index.md`
+- M `docs/User Guide/audience/segments/segment_extension/sql_segments/use_cases/index.md`
+- M `docs/User Guide/brazeai/agents/examples/index.md`
+- M `docs/User Guide/brazeai/mcp_server/available_api_functions/index.md`
+- M `docs/User Guide/channels/email/email_setup/open_pixel_and_click_tracking/index.md`
+- M `docs/User Guide/channels/email/faq/index.md`
+- M `docs/User Guide/channels/email/reporting/analytics_glossary/index.md`
+- M `docs/User Guide/channels/in_app_messages/faq/index.md`
+- M `docs/User Guide/channels/kakaotalk/kakaotalk_setup/index.md`
+- M `docs/User Guide/data/distribution/braze_currents/event_glossary/customer_behavior_events/index.md`
+- M `docs/User Guide/data/distribution/braze_currents/event_glossary/message_engagement_events/index.md`
+- M `docs/User Guide/data/distribution/braze_currents/event_glossary/user_profiles_events/index.md`
+- M `docs/User Guide/messaging/canvas/faqs/index.md`
+- M `docs/User Guide/messaging/canvas/managing_canvases/canvas_threshold_alerts/index.md`
+- M `docs/User Guide/messaging/design_and_edit/personalize/liquid/liquid_use_cases/index.md`

docs/API/api_campaigns/index.md

@@ -11,6 +11,8 @@ Send that information to your development team to use in the API request, along
 
 After the campaign begins, you can view the results in the dashboard. API campaigns use the Braze [messaging APIs](https://www.braze.com/docs/api/endpoints/messaging), which have the same detailed reporting and retargeting options as campaigns created completely through the dashboard.
 
+Because API campaigns always include a `campaign_id`, their sends are reflected in dashboard stats. If you call [`/messages/send`](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_messages) without a `campaign_id`, Braze doesn't increment those metrics—sends still appear in the [Message Activity Log](https://www.braze.com/docs/user_guide/administer/global/workspace_settings/logs_and_alerts/message_activity_log), but not in email performance metrics in the dashboard.
+
 **Warning:**
 
 

docs/API/endpoints/apps/post_update_push_credential/index.md

@@ -1,4 +1,4 @@
-<div id='api_taypzhevkvtb' class='api_div' data-search-keywords='prerequisites app_id apple certificate jwt_key_id jwt_team_id jwt_bundle_id apns_gateway firebase credential huawei app_secret kindle client_id client_secret message'>
+<div id='api_evbmwrzvveun' class='api_div' data-search-keywords='prerequisites app_id apple certificate jwt_key_id jwt_team_id jwt_bundle_id apns_gateway firebase credential huawei app_secret kindle client_id client_secret message'>
 <h1 id="update-push-credentials">Update push credentials</h1>
 <div class="api_type"><div class="method post ">post</div>
 <p>/apps/push_credential/update</p>

docs/API/endpoints/catalogs/catalog_fields/asynchronous/delete_catalog_field/index.md

@@ -1,4 +1,4 @@
-<div id='api_krgdvljbqunp' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_lzlaxybiqtto' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="delete-catalog-field">Delete catalog field</h1>
 <div class="api_type"><div class="method delete ">delete</div>
 <p>/catalogs/{catalog_name}/fields/{field_name}</p>

docs/API/endpoints/catalogs/catalog_fields/asynchronous/post_create_catalog_fields/index.md

@@ -1,4 +1,4 @@
-<div id='api_gszpqszthwup' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_bqutadnouyhk' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="create-catalog-fields">Create catalog fields</h1>
 <div class="api_type"><div class="method post ">post</div>
 <p>/catalogs/{catalog_name}/fields</p>

docs/API/endpoints/catalogs/catalog_items/asynchronous/delete_catalog_items_bulk/index.md

@@ -1,4 +1,4 @@
-<div id='api_jblcumdrxkbc' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_gclogfhvrkwb' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="delete-multiple-catalog-items">Delete multiple catalog items</h1>
 <div class="api_type"><div class="method delete ">delete</div>
 <p>/catalogs/{catalog_name}/items</p>

docs/API/endpoints/catalogs/catalog_items/asynchronous/patch_catalog_items_bulk/index.md

@@ -1,4 +1,4 @@
-<div id='api_wpaxmexaykme' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_qkjnbwnqnhhr' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="edit-multiple-catalog-items">Edit multiple catalog items</h1>
 <div class="api_type"><div class="method patch ">patch</div>
 <p>/catalogs/{catalog_name}/items</p>

docs/API/endpoints/catalogs/catalog_items/asynchronous/post_create_catalog_items_bulk/index.md

@@ -1,4 +1,4 @@
-<div id='api_abdoweetzkvn' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_ldrqgmyytnud' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="create-multiple-catalog-items">Create multiple catalog items</h1>
 <div class="api_type"><div class="method post ">post</div>
 <p>/catalogs/{catalog_name}/items</p>

docs/API/endpoints/catalogs/catalog_items/asynchronous/put_update_catalog_items/index.md

@@ -1,4 +1,4 @@
-<div id='api_udzqsjtcgyup' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_kcrpawrefgij' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="replace-catalog-items">Replace catalog items</h1>
 <div class="api_type"><div class="method put ">put</div>
 <p>/catalogs/{catalog_name}/items</p>

docs/API/endpoints/catalogs/catalog_items/synchronous/delete_catalog_item/index.md

@@ -1,4 +1,4 @@
-<div id='api_cousrhfdxurk' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
+<div id='api_dunyqpnxcucs' class='api_div' data-search-keywords='prerequisites message errors id parameters parameter_values'>
 <h1 id="delete-a-catalog-item">Delete a catalog item</h1>
 <div class="api_type"><div class="method delete ">delete</div>
 <p>/catalogs/{catalog_name}/items/{item_id}</p>