Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Body

application/json
productId
string
required
Minimum string length: 1
masterCents
integer
required
Required range: 0 <= x <= 9007199254740991
steps
object[]
required
expectedVersion
integer
default:1
Required range: 0 <= x <= 9007199254740991

Response

The persisted schedule identity + its bumped version.

The persisted schedule identity + its bumped version.

id
string
required

The persisted schedule id.

productId
string
required

The product the schedule is for.

version
integer
required

The version the write landed at (bumped on update).

Required range: -9007199254740991 <= x <= 9007199254740991
masterCents
integer
required

The master (base) gross price in cents.

Required range: 0 <= x <= 9007199254740991
stepCount
integer
required

How many steps the persisted schedule carries.

Required range: -9007199254740991 <= x <= 9007199254740991