Approve a sensitive action

Lets a colleague authorise one action the signed-in staff member cannot perform alone, such as a discount above the outlet cap or voiding an item already sent to the kitchen.

The approver enters their own login PIN as approval_pin. If their role holds the permission the action needs, the response carries an approval_token. Pass it on the operation that performs the action; it is single-use, expires within minutes, and only works for that action and subject_id (the order or order item). The approver is recorded on the result.

Requires the requesting staff member's own X-Staff-Token. Shares the login PIN lockout.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Payload for manager/admin approval.

approval_pin carries the approver's normal login PIN — the same
credential the staff sign-in screen takes. There is no separate approval
credential; the field name is kept for wire compatibility with pos-app.

string
enum
required

The action being approved

string
required

Id of the record being acted on (order or order item)

DraftDiscountTerms | null
Headers
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json