Update a tier — price/stock + the server-enforced restrictions (API token, merchant:write)

PATCH /v1/integration/tiers/{id}

Error

A valid request URL is required to generate request examples

200

{
  "tier": {
    "id": "<string>",
    "priceMinor": 123,
    "currency": "<string>",
    "eventId": "<string>",
    "title": "<string>",
    "kind": "<string>",
    "availableCount": 123,
    "poolId": "<string>",
    "maxQtyPerPurchase": 123,
    "sellable": true
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Body

application/json

priceMinor · integer

Integer MINOR units — never a float (invariant #1).

availableCount · integer

Restock a tier that has its own counter. A pooled tier refuses this — restock its pool (PATCH /pools/{id}).

expectedOccurrenceRevision · integer

Optional version of the location binding used to interpret sale-window input; stale edits return 409.

Required range: 1 <= x <= 2147483646

poolId · string | null

Attach the tier to a shared pool (its own counter goes away), or null to detach it — then also send availableCount for its own counter. Refused while the tier has a live hold.

maxQtyPerPurchase · integer | null

sellable · boolean

onSaleStart · string<date-time> | null

RFC 3339 with an explicit offset; null clears.

onSaleEnd · string<date-time> | null

RFC 3339 with an explicit offset; null clears.

allowedGeos · string[] | null

allowedSchemes · string[] | null

role · enum<string>

Available options: primary, addon

category · string | null

categoryLabel · string | null

countsTowardPartySize · boolean | null

linkRule · object | null

Show child attributes

Response

200 - application/json

Default Response

tier · object · required

Show child attributes