Skip to content
Cloudflare Docs

Get started

You can configure the Metadata Boundary to select the region where your logs and analytics are stored via API or dashboard.

Currently, this can only be applied at the account-level. If you only want the Metadata Boundary to be applied on a portion of zones beneath the same account, you will have to move the rest of zones to a new account.

Configure Customer Metadata Boundary in the dashboard

To configure Customer Metadata Boundary in the dashboard:

  1. Log in to the Cloudflare dashboard ↗ and select your account.
  2. Go to Manage Account > Configurations.
  3. In Customer Metadata Boundary, select the region you want to use. You have the option to select EU or US. If you want to select both regions, select Global instead.

Configure Customer Metadata Boundary via API

You can also configure Customer Metadata Boundary via API.

Currently, only SuperAdmins and Admin roles can edit DLS configurations. Use the Account-level Logs:Read/Write API permissions for the /logs/control/cmb endpoint to read/write Customer Metadata Boundary configurations.

These are some examples of API requests.

Get current regions

Here is an example request using cURL to get current regions (if any):

Terminal window
curl -s -D "/dev/stderr" https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/logs/control/cmb/config -X GET \
-H "X-Auth-Email: <EMAIL>" \
-H "X-Auth-Key: <KEY>" \
| jq '.'

Setting regions

Here is an example request using cURL to set regions:

Terminal window
curl -s -D "/dev/stderr" https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/logs/control/cmb/config -X POST -d '
{
    "regions": "eu"
}
' \
-H "X-Auth-Email: <EMAIL>" \
-H "X-Auth-Key: <KEY>" \
| jq '.'

This will overwrite any previous regions. Change will be in effect after several minutes.

Delete regions

Here is an example request using cURL to delete regions:

Terminal window
curl -s -D "/dev/stderr" https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/logs/control/cmb/config -X DELETE \
-H "X-Auth-Email: <EMAIL>" \
-H "X-Auth-Key: <KEY>" \
| jq '.'

View or change settings

To view or change your Customer Metadata Boundary setting:

  1. Log in to the Cloudflare dashboard ↗ and select your account.
  2. Go to Manage Account > Configurations > Preferences.
  3. Locate the Customer Metadata Boundary section.
Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings