---
title: "Bulk Update Access"
method: PUT
path: "/api/v1/admin/block/dataset-restrictions/bulk-update/"
tags: ["Admin APIs", "block-dataset-restrictions"]
---

# Bulk Update Access

`PUT /api/v1/admin/block/dataset-restrictions/bulk-update/`

Apply a batch of access-grant changes in one transaction with a
single commit (PRO-1667) — powers the Manage Data Restrictions admin
UI's Save action, whether the batch came from By Dataset mode, By
Client mode, or "apply to all valid clients".

Fires exactly ONE Slack message summarizing the whole batch (not one
per dataset/client) — see ``block_slack.send_bulk_access_changed``.

## Request body

- BlockClientDataAccessBulkUpdate[]
  - `client_id` string, uuid, required
  - `dataset_id` string, required
  - `cut` string, nullable
  - `access` boolean
  - `sample_access` boolean, nullable
  - `served_lag` string, nullable
  - `rationale` string, required

## Response `200`

Successful Response

- BulkUpdateResponse
  - `changed` integer, required
  - `results` BulkUpdateResultRow[], required
    - `client_id` string, uuid, required
    - `client_name` string, nullable
    - `dataset_id` string, required
    - `cut` string, nullable
    - `previous_access` boolean, required
    - `previous_sample_access` boolean
    - `previous_served_lag` string, nullable
    - `access` boolean, required
    - `sample_access` boolean
    - `served_lag` string, nullable
    - `rationale` string, required

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