Skip to main content
PATCH
Update an external program

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Headers

Idempotency-Key
string

Retry-safe key; a repeat of the same request replays the first response

Maximum string length: 255

Path Parameters

id
integer
required

External program id

Body

application/json
name
string

The club's label for it, shown to staff and members.

Required string length: 1 - 255
code
string

Short identifier, unique in the organization: lowercase letters, digits, hyphens and underscores.

Required string length: 1 - 64
Pattern: ^[a-z0-9_-]+$
clubId
integer | null

The one club it is honoured at. null: every club.

visibility
enum<string>

Public and Member_only: members can choose it themselves. Private: only staff can apply it. Defaults to Public on create.

Available options:
Private,
Member_only,
Public
coveredAmountPerVisit
number | null

What the program pays per visit, tax included; the member pays the rest of the price. null: the program pays for the whole visit.

Required range: x >= 0.01
additionalPricePerVisit
number | null

What the member pays on top, per visit.

Required range: x >= 0
validFor
object

Replaces the stored value wholesale when sent on an update.

operatingHours
object | null

When it can be used, by weekday. Empty or null: whenever the club is open. Replaces the stored value when sent.

knownProgram
enum<string> | null

Which known program this is, such as MultiSport; null for the club's own. An organization has at most one of each, and it is only offered where its cards are supported (MultiSport: Bulgaria).

Available options:
multisport,
null
cardFormat
enum<string> | null

The card members carry for it. A known program reads its own card; any other program only number. null: no cards.

Available options:
number,
multisport,
null
isActive
boolean

false stops it being chosen for new bookings and check-ins; visits already recorded stay.

Response

The updated external program

A third party - MultiSport, a municipal scheme, a corporate wellness card - that pays for members' visits.

id
integer
name
string
code
string
clubId
integer | null

null: honoured at every club.

club
object | null
isActive
boolean

An inactive program cannot be chosen for new bookings or check-ins.

visibility
enum<string>
Available options:
Private,
Member_only,
Public
coveredAmountPerVisit
number | null

What the program pays per visit. null: the whole visit.

additionalPricePerVisit
number | null

What the member pays on top, per visit.

validFor
object
operatingHours
object
knownProgram
enum<string> | null
Available options:
multisport,
null
cardFormat
enum<string> | null
Available options:
number,
multisport,
null
createdAt
string<date-time>
updatedAt
string<date-time>