Skip to main content
PUT
Update a package

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

packageId
string
required

The service package — a bundle of prepaid sessions drawn down by bookings.

Minimum string length: 1
Example:

"pkg_01kv7n10k0fnptwk81wkm59vj7"

Body

application/json

Update data

name
object
description
object
pricing
object[]
Minimum array length: 1
creditCount
integer
Required range: x > 0
discountPercent
number

Percentage discount (0-100) recorded when this package's prices were seeded from the offering's prices (price = offering price * creditCount * (1 - discountPercent/100)). Informational metadata only: pricing is the authoritative source of the amounts charged. Individual prices can be manually overridden after seeding, and the offering's prices may change later, so this value is not guaranteed to match the actual prices - never derive amounts from it.

Required range: 0 <= x <= 100
validityDays
integer | null
Required range: x > 0
capacity
integer
Required range: x > 0

Response

Updated

data
object
required