---
title: "Set Client Sample Coupled"
method: PATCH
path: "/api/v1/admin/block/dataset-restrictions/client/{client_id}/sample-coupled"
tags: ["Admin APIs", "block-dataset-restrictions"]
---

# Set Client Sample Coupled

`PATCH /api/v1/admin/block/dataset-restrictions/client/{client_id}/sample-coupled`

Toggle whether the client's Block sample access follows live/bulk.

Entering MANUAL mode (``False``) is a pure flag flip — existing
live/sample values are left untouched. Re-COUPLING (``True``) is blocked
when any dataset has a live≠sample mismatch: the caller must resolve
those first (409 ``sample_mismatch`` with the offending datasets/cuts).
A clean re-couple needs no provider reconcile — every row already
matches, so effective sample is unchanged.

## Path parameters

- `client_id` string, uuid, required

## Request body

- ClientBlockSampleAccessFollowsPatch — Toggle whether Block sample access mirrors live/bulk access for this client (True = coupled). Re-coupling is rejected when any dataset has a live≠sample mismatch.
  - `block_sample_access_follows_live` 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)