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

# Update Dataset Setting

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

Partial update of dataset-level CAMS levers. Each field is
independent — omit a key to leave it alone. ``status`` drives the
sidebar segmented control and the customer "Available" rail (only
``ready`` datasets are surfaced). ``trial_duration_months`` overrides
the global 1-month default for requests created against this dataset
(existing requests are unaffected — they snapshot the duration at
creation).

## Path parameters

- `dataset_id` string, required

## Request body

- DatasetSettingUpdateBody
  - `status` 'hidden' | 'coming_soon' | 'ready'
  - `trial_duration_months` integer, nullable
  - `clear_trial_duration` boolean
  - `notes` string, nullable
  - `update_notes` boolean

## 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)