Skip to main content
POST
Preview a batch of scheduled pricing changes without mutating state (Admin only).

Authorizations

Authorization
string
header
required

JWT access token for user authentication (Authorization: Bearer <jwt_token>). Create via POST /users/me/access_tokens.

Body

application/json

Request to preview or confirm a batch of scheduled pricing changes.

changes
object[]
required
batchId
string<uuid> | null

Idempotency key for the batch. Generate once client-side and reuse on retries so a re-confirm never sends duplicate emails. Confirm generates one when omitted.

changeReason
string | null

Optional reason recorded in model history when the change is applied.

Response

Pricing change notification preview

models
object[]
required
organizationCount
integer<int64>
required
recipientCount
integer<int64>
required

Distinct recipient emails across the whole batch.

usageWindowDays
integer<int64>
required