---
title: "Publish Block Dataset Tou"
method: POST
path: "/api/v1/admin/legal/block-tous/{dataset_id}/versions"
tags: ["Admin APIs", "Legal"]
---

# Publish Block Dataset Tou

`POST /api/v1/admin/legal/block-tous/{dataset_id}/versions`

Publish a new TOU version for ``dataset_id``.

## Path parameters

- `dataset_id` string, required

## Request body

- BlockDatasetTOUUpdateRequest — Publish a new version of a dataset's TOU. Mirrors ``SignupTOUUpdateRequest`` but is scoped per ``dataset_id`` (which comes from the URL path, not the body).
  - `content` string, required
  - `change_type` 'substantive' | 'typo_formatting', required
  - `change_reason` string, required — Required reason for change
  - `effective_at` string, date-time, nullable — Effective date/time for this TOU version. Defaults to published_at if not provided.
  - `base_version_id` string, uuid, nullable — Optimistic concurrency check. The block-dataset TOU version id the user based their edit on. If the latest published version for this dataset has a different id, the update is rejected and the user should reload.

## Response `200`

Successful Response

- BlockDatasetTOUVersionResponse — A single published version of a dataset's TOU.
  - `id` string, uuid, required
  - `dataset_id` string, required
  - `version_num` integer, required
  - `content` string, required
  - `checksum` string, required
  - `published_at` string, date-time, required
  - `effective_at` string, date-time, required
  - `requires_reacceptance` boolean, required
  - `change_reason` string, required
  - `created_at` string, date-time, required
  - `created_by` string, nullable

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