---
title: "Schedule Price Change"
method: POST
path: "/api/v1/admin/block/pricing"
tags: ["Admin APIs", "block-pricing"]
---

# Schedule Price Change

`POST /api/v1/admin/block/pricing`

## Request body

- SchedulePriceChangeBody — Insert a new effective-date row. ``expected_row_version`` is the row_version the UI saw when it loaded the form. If a concurrent save bumped it on the same ``(dataset_id, cut, access_type)`` since then, the service raises ``StaleStateError`` and the UI prompts a reload. For *new* SKUs that don't have any prior row, pass ``expected_row_version=0`` so the service can distinguish first insert from a stale concurrent overwrite.
  - `dataset_id` string, required
  - `cut` string, nullable
  - `access_type` 'Forward Feed' | 'Historic', required
  - `effective_date` string, date, required
  - `price` union
    - number
    - string
  - `revenue_share_pct` union
    - number
    - string
  - `deployment_fee` boolean, nullable
  - `monthly_fee` union
    - number
    - string
  - `expected_row_version` integer
  - `rationale` string, nullable

## Response `201`

Successful Response

- BlockPricingRead
  - `id` string, uuid, required
  - `dataset_id` string, required
  - `cut` string, nullable
  - `label` string, nullable
  - `access_type` 'Forward Feed' | 'Historic', required
  - `effective_date` string, date, required
  - `price` string, nullable, required
  - `revenue_share_pct` string, nullable, required
  - `deployment_fee` boolean
  - `monthly_fee` string, nullable, required
  - `bulk_row_status` 'AVAILABLE' | 'IN_PROCESS' | 'COMING_SOON', required
  - `internal_name` string, nullable
  - `rationale` string, nullable
  - `row_version` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, nullable
  - `updated_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)