Skip to content
Sanmopia Modernization

Resolve branch/HQ reservation financial mutation locks

Switch to Zen Mode
POST
/operator-financial-mutation-lock-decisions/{reservationId}
curl --request POST \
  --url https://example.com/operator-financial-mutation-lock-decisions/example \
  --header 'Content-Type: application/json' \
  --data '{ "branchActor": { "actorUserId": "example", "branchId": 1, "role": "example" }, "reservationStatus": "example", "serviceEndOn": "2026-04-15", "evaluatedAt": "2026-04-15T12:00:00Z", "requestedFields": [ "price_version" ] }'

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
reservationId
required
string
>= 1 characters

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
OperatorFinancialMutationLockDecisionRequest
object
branchActor
required
object
actorUserId
required
string
>= 1 characters
branchId
required
integer
>= 1
role
required
string
>= 1 characters
key
additional properties
reservationStatus
required
string
>= 1 characters
serviceEndOn
required
string format: date
evaluatedAt
required
string format: date-time
requestedFields
Array<string>
unique items
Allowed values: price_version service_balance payment_date reservation_status
key
additional properties

Responses

Section titled “Responses”

200

Section titled “200”

Field-level financial mutation lock decision

Media typeapplication/json
OperatorFinancialMutationLockDecisionResponse
object
reservationId
required
string
>= 1 characters
decision
required
object
actorKind
required
string
Allowed values: mother caregiver branch_operator hq_admin
reservationStatus
required
string
>= 1 characters
serviceEndOn
required
string format: date
evaluatedAt
required
string format: date-time
policyVersionLabel
required
string
>= 1 characters
locks
required
Array<object>
>= 1 items
object
field
required
string
Allowed values: price_version service_balance payment_date reservation_status
locked
required
boolean
reasonCode
required
One of:
string
Allowed values: branch_final_state_locked service_window_closed stage_capability_denied
messageKey
required
string | null
>= 1 characters
requiredCapabilities
required
Array<string>
sourceAnchor
required
string
>= 1 characters
key
additional properties
key
additional properties
key
additional properties

400

Section titled “400”

Lock preview payload is invalid

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Actor cannot view reservation financial mutation locks