---
title: Manage measurement settings and saved filters
description: Update workspace measurement conditions, inspect their revision
  history, and save reusable filters.
canonical_url: https://orchestor.io/docs/en/cli/workflows/measurement-configuration
markdown_url: https://orchestor.io/docs/en/cli/workflows/measurement-configuration.md
contentType: how-to
---

# Manage measurement settings and saved filters

Authenticate with permission to change measurement settings. Confirm the target workspace before you continue.

## Read the current settings

```bash
orc workspaces measurement-configurations get --workspace WORKSPACE_ID --json
```

The API returns `404` when the workspace does not have a configuration. Confirm that you selected the intended workspace before you create one.

## Update the measurement configuration

```bash
printf '%s' '{"default_location":{"level":"country","code":"JP"},"default_language":"ja-JP","platform_selection":{"mode":"explicit","ids":["MODEL_ID"]}}' \
  | orc workspaces measurement-configurations update --workspace WORKSPACE_ID --stdin --json
orc workspaces measurement-configurations get --workspace WORKSPACE_ID --json
```

An update appends a configuration revision and makes that revision active. A failed update leaves the previous active configuration unchanged. Read the result and confirm that the location, language, and model IDs match your intended values.

## Inspect configuration revisions

```bash
orc workspaces measurement-configurations revisions list --workspace WORKSPACE_ID --limit 20 --json
```

If the response includes a next cursor, pass it with `--cursor CURSOR` to read the next page.

## Save and read back a filter

```bash
printf '%s' '{"name":"Japan model filter","filter":{"countries":["JP"],"models":["MODEL_ID"],"tags":["TAG_ID"]}}' \
  | orc saved-views create --workspace WORKSPACE_ID --stdin --json
orc saved-views list --workspace WORKSPACE_ID --json
```

A saved view stores its name and filter. Compare the create and list responses to confirm that nested filter fields remain unchanged.

[workspaces reference](https://orchestor.io/docs/en/cli/workspaces.md) · [saved-views reference](https://orchestor.io/docs/en/cli/saved-view.md) · [Workflow index](https://orchestor.io/docs/en/cli/workflows.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)