---
title: "Update Dataset Sample Settings"
method: PUT
path: "/api/v1/admin/block/pricing/dataset-settings/{dataset_id}/sample"
tags: ["Admin APIs", "block-pricing"]
---

# Update Dataset Sample Settings

`PUT /api/v1/admin/block/pricing/dataset-settings/{dataset_id}/sample`

Turn the sample catalog on/off per ``(dataset, cut)`` for ALL clients.

Off hides the cut's sample in the SQL Editor and API for every client;
live/bulk access is unchanged. Absent ⇒ enabled. Each changed cut fans
out a per-cut grant/revoke across providers (only when the value actually
changed, so a no-op save is cheap).

## Path parameters

- `dataset_id` string, required

## Request body

- DatasetSampleUpdateBody — Dataset-wide sample kill switch, one entry per changed cut.
  - `cuts` SampleCutUpdate[], required
    - `cut` string, nullable
    - `enabled` boolean, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)