Skip to main content
POST
Change a booking status

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"

bookingId
string
required

The booking — one scheduled unit of service occupying supplier time.

Minimum string length: 1
Example:

"bk_01kv7q41n2hbqxwm03ymn7bxl9"

Body

application/json

New status

status
enum<string>
required
Available options:
STARTED,
AWAITING_CONFIRMATION,
COMPLETED,
CANCELLED,
CLIENT_NO_SHOW,
SUPPLIER_NO_SHOW
cancellationReason
string

Required when status is CANCELLED; omitting it then is a 400. Why the booking was cancelled.

Minimum string length: 1
creditTreatment
enum<string>

CANCELLED only. What happens to a package session credit: RETURN (the default when omitted) puts the session back on the order item; FORFEIT keeps it spent. Sending it for a booking that is not a package session is a 422 NO_SESSION_CREDIT.

Available options:
RETURN,
FORFEIT
Example:

"FORFEIT"

Response

Updated booking

data
object
required