<!-- x-generated: Generated by the Hyperscale artifact pipeline; do not edit by hand -->

# Examples

Install the generated TypeScript SDK from the Hyperscale Kit minted by the Product's Developers desk before running these source-tree examples. CI can instead authenticate `GET /v1/llms.txt` with a Product API key to discover the latest Build's exact hosted npm package:

```bash
npm install ./sdks/typescript
```

Each example on an SDK-callable operation is a complete runnable TypeScript program using the `createHyperscale` client the Kit's TypeScript package exports (where an example body has no SDK shape, the raw JSON request is shown instead). Provision a key first as shown in the [Quickstart](quickstart.md). Operations that are not SDK-callable sit in their own sections at the end, grouped by the principal that authorizes them; each section states how that principal authenticates. Sample IDs are setup-owned sandbox IDs; replace them with IDs returned by your Hyperscale setup.

Every snippet below imports from `@hyperscale/tenant-sdk-your-capabilities`, which stands in for your own package name: the Kit names its TypeScript package after your Product's capabilities. Your exact name is the `name` field of `sdks/typescript/package.json` in the unpacked Kit, and an authenticated `GET /v1/llms.txt` returns it for the hosted copy of the same package.

## Index

- account.create: customer_balance_account (POST /v1/accounts)
- account.statement.export: monthly-csv (GET /v1/accounts/{accountId}/statements/{period}/export)
- beneficiary.create: create_seller_beneficiary (POST /v1/beneficiaries)
- beneficiary.verify: verify_seller_payout_beneficiary (POST /v1/beneficiary-verifications)
- card.activate: activate_virtual_card (POST /v1/cards/{cardId}/activate)
- card.cancel: cancel_virtual_card (POST /v1/cards/{cardId}/cancel)
- card.create: issue_controlled_virtual_card (POST /v1/cards)
- card.freeze: freeze_virtual_card (POST /v1/cards/{cardId}/freeze)
- card.unfreeze: unfreeze_virtual_card (POST /v1/cards/{cardId}/unfreeze)
- card.update: tighten_virtual_card_controls (PATCH /v1/cards/{cardId})
- card_authorization.approve: approve_authorization_after_jit_decision (POST /v1/card-authorizations/{cardAuthorizationId}/approve)
- card_authorization.capture: capture_completed_purchase (POST /v1/card-authorizations/{cardAuthorizationId}/capture)
- card_authorization.create: request_retail_authorization (POST /v1/card-authorizations)
- card_authorization.decline: decline_rejected_authorization (POST /v1/card-authorizations/{cardAuthorizationId}/decline)
- card_authorization.reverse: reverse_uncaptured_authorization (POST /v1/card-authorizations/{cardAuthorizationId}/reverse)
- card_dispute.create: file_unauthorized_purchase_dispute (POST /v1/card-disputes)
- card_dispute.review: begin_card_dispute_review (POST /v1/card-disputes/{cardDisputeId}/review)
- card_dispute.update: add_card_dispute_evidence (PATCH /v1/card-disputes/{cardDisputeId})
- card_dispute.win: return_won_dispute_amount (POST /v1/card-disputes/{cardDisputeId}/win)
- card_transaction.create: record_captured_card_purchase (POST /v1/card-transactions)
- card_transaction.refund: refund_returned_purchase (POST /v1/card-transactions/{cardTransactionId}/refund)
- cardholder.activate: activate_approved_cardholder (POST /v1/cardholders/{cardholderId}/activate)
- cardholder.close: close_cardholder_relationship (POST /v1/cardholders/{cardholderId}/close)
- cardholder.create: create_customer_cardholder (POST /v1/cardholders)
- cardholder.resume: resume_cardholder_access (POST /v1/cardholders/{cardholderId}/resume)
- cardholder.suspend: suspend_cardholder_access (POST /v1/cardholders/{cardholderId}/suspend)
- cardholder.update: update_cardholder_contact (PATCH /v1/cardholders/{cardholderId})
- circle_membership.create: join_family_circle (POST /v1/circle-memberships)
- circle_membership.create: join_family_circle_second (POST /v1/circle-memberships)
- circle_membership.create: join_family_circle_third (POST /v1/circle-memberships)
- claim.approve: approve_assessed_claim (POST /v1/claims/{claimId}/approve)
- claim.assess: complete_claim_assessment (POST /v1/claims/{claimId}/assess)
- claim.attest: attest_insurer_approval (POST /v1/claims/{claimId}/attest)
- claim.create: file_accidental_damage_claim (POST /v1/claims)
- claim.deny: deny_unapproved_claim (POST /v1/claims/{claimId}/deny)
- claim.pay: pay_approved_claim (POST /v1/claims/{claimId}/pay)
- claim.reverse: reverse_approved_claim (POST /v1/claims/{claimId}/reverse)
- claim.update: add_claim_evidence_summary (PATCH /v1/claims/{claimId})
- collections_case.assign: assign_collections_case (POST /v1/collections-cases/{collectionsCaseId}/assign)
- collections_case.create: open_case_for_overdue_installment (POST /v1/collections-cases)
- collections_case.recall: recall_collections_case (POST /v1/collections-cases/{collectionsCaseId}/recall)
- collections_case.recover: record_lump_sum_recovery (POST /v1/collections-cases/{collectionsCaseId}/recover)
- contact_attempt.create: record_call_with_promise_to_pay (POST /v1/contact-attempts)
- contact_attempt.void: void_contact_attempt (POST /v1/contact-attempts/{contactAttemptId}/void)
- credit_agreement.advance: advance_credit_agreement (POST /v1/credit-agreements/{creditAgreementId}/advance)
- credit_agreement.create: open_credit_agreement (POST /v1/credit-agreements)
- credit_agreement.settle: settle_credit_agreement (POST /v1/credit-agreements/{creditAgreementId}/settle)
- credit_agreement.write_off: write_off_credit_agreement (POST /v1/credit-agreements/{creditAgreementId}/write-off)
- customer.create: customer (POST /v1/customers)
- customer.create: organization_customer (POST /v1/customers)
- customer.login: default (POST /v1/customer-identity/login)
- customer.logout: default (POST /v1/customer-identity/logout)
- customer.session.revoke: default (POST /v1/customer-identity/sessions/{customerSessionId}/revoke)
- customer.signup: default (POST /v1/customer-identity/signup)
- deposit_hold.cancel: cancel_security_deposit (POST /v1/deposit-holds/{depositHoldId}/cancel)
- deposit_hold.claim: claim_security_deposit (POST /v1/deposit-holds/{depositHoldId}/claim)
- deposit_hold.create: create_security_deposit (POST /v1/deposit-holds)
- deposit_hold.fund: fund_security_deposit (POST /v1/deposit-holds/{depositHoldId}/fund)
- escrow_order.cancel: cancel_unfunded_escrow (POST /v1/escrow-orders/{escrowOrderId}/cancel)
- escrow_order.collect_penalty: collect_disputed_refund_penalty (POST /v1/escrow-orders/{escrowOrderId}/collect-penalty)
- escrow_order.create: open_vehicle_escrow (POST /v1/escrow-orders)
- escrow_order.dispute: hold_funds_for_dispute (POST /v1/escrow-orders/{escrowOrderId}/dispute)
- escrow_order.fund: fund_purchase_escrow (POST /v1/escrow-orders/{escrowOrderId}/fund)
- escrow_order.quote: quote_disputed_refund (POST /v1/escrow-orders/{escrowOrderId}/quote)
- escrow_order.refund: confirm_disputed_refund (POST /v1/escrow-orders/{escrowOrderId}/refund)
- escrow_order.release: release_escrow (POST /v1/escrow-orders/{escrowOrderId}/release)
- escrow_order.resume: resume_after_resolution (POST /v1/escrow-orders/{escrowOrderId}/resume)
- escrow_order.update: annotate_unfunded_escrow (PATCH /v1/escrow-orders/{escrowOrderId})
- event.list: sandbox_events (GET /v1/events)
- event.retrieve: sandbox_event (GET /v1/events/{eventId})
- expected_payment.cancel: cancel_expected_payment (POST /v1/expected-payments/{expectedPaymentId}/cancel)
- expected_payment.create: expect_vehicle_payment (POST /v1/expected-payments)
- exposure_arrangement.approve: approve_borrower_exposure (POST /v1/exposure-arrangements/{exposureArrangementId}/approve)
- exposure_arrangement.close: close_borrower_exposure (POST /v1/exposure-arrangements/{exposureArrangementId}/close)
- exposure_arrangement.create: open_borrower_exposure (POST /v1/exposure-arrangements)
- financial_address.create: request_customer_financial_address (POST /v1/financial-addresses)
- financial_address.disable: disable_financial_address (POST /v1/financial-addresses/{financialAddressId}/disable)
- flight_booking.amend_collect: collect_reissued_fare_increase (POST /v1/flight-bookings/{flightBookingId}/amend-collect)
- flight_booking.amend_fee: collect_reissue_fee (POST /v1/flight-bookings/{flightBookingId}/amend-fee)
- flight_booking.amend_refund: refund_reissued_fare_decrease (POST /v1/flight-bookings/{flightBookingId}/amend-refund)
- flight_booking.cancel_confirm: confirm_flight_cancellation (POST /v1/flight-bookings/{flightBookingId}/cancel-confirm)
- flight_booking.cancel_quote: quote_flight_cancellation (POST /v1/flight-bookings/{flightBookingId}/cancel-quote)
- flight_booking.confirm: confirm_flight_booking (POST /v1/flight-bookings/{flightBookingId}/confirm)
- flight_booking.create: hold_flight_booking (POST /v1/flight-bookings)
- flight_booking.release: release_flight_booking (POST /v1/flight-bookings/{flightBookingId}/release)
- funding_commitment.create: pledge_into_round (POST /v1/funding-commitments)
- funding_round.close: settle_collected_round (POST /v1/funding-rounds/{fundingRoundId}/close)
- funding_round.create: open_equipment_round (POST /v1/funding-rounds)
- held_settlement.abandon: abandon_held_settlement (POST /v1/held-settlements/{heldSettlementId}/abandon)
- held_settlement.create: open_held_settlement (POST /v1/held-settlements)
- hotel_stay.amend_collect: collect_extended_stay_increase (POST /v1/hotel-stays/{hotelStayId}/amend-collect)
- hotel_stay.amend_fee: collect_date_change_fee (POST /v1/hotel-stays/{hotelStayId}/amend-fee)
- hotel_stay.amend_refund: refund_shortened_stay_decrease (POST /v1/hotel-stays/{hotelStayId}/amend-refund)
- hotel_stay.cancel_confirm: confirm_weekend_stay_cancel (POST /v1/hotel-stays/{hotelStayId}/cancel-confirm)
- hotel_stay.cancel_quote: quote_weekend_stay_cancel (POST /v1/hotel-stays/{hotelStayId}/cancel-quote)
- hotel_stay.confirm: confirm_weekend_stay (POST /v1/hotel-stays/{hotelStayId}/confirm)
- hotel_stay.create: hold_weekend_stay (POST /v1/hotel-stays)
- hotel_stay.release: release_weekend_stay (POST /v1/hotel-stays/{hotelStayId}/release)
- installment.create: schedule_installment (POST /v1/installments)
- installment.write_off: write_off_overdue_installment (POST /v1/installments/{installmentId}/write-off)
- internal_transfer.create: marketplace_seller_transfer (POST /v1/internal-transfers)
- internal_transfer.post: post_reserved_transfer (POST /v1/internal-transfers/{transferId}/post)
- internal_transfer.reserve: reserve_account_transfer (POST /v1/internal-transfers/reserve)
- internal_transfer.void: void_reserved_transfer (POST /v1/internal-transfers/{transferId}/void)
- lender_distribution.create: claim_lender_distribution (POST /v1/lender-distributions)
- listing.create: draft_vehicle_offer (POST /v1/listings)
- listing.publish: publish_vehicle_offer (POST /v1/listings/{listingId}/publish)
- listing.reopen: reopen_refunded_offer (POST /v1/listings/{listingId}/reopen)
- listing.reserve: reserve_funded_offer (POST /v1/listings/{listingId}/reserve)
- listing.sell: sell_funded_offer (POST /v1/listings/{listingId}/sell)
- listing.update: attach_funded_escrow (PATCH /v1/listings/{listingId})
- listing.withdraw: withdraw_unreserved_offer (POST /v1/listings/{listingId}/withdraw)
- motor_policy.bind: bind_vehicle_cover (POST /v1/motor-policies/{motorPolicyId}/bind)
- motor_policy.cancel: cancel_unbound_vehicle_cover (POST /v1/motor-policies/{motorPolicyId}/cancel)
- motor_policy.create: quote_vehicle_cover (POST /v1/motor-policies)
- order.cancel: cancel_safely_retired_purchase (POST /v1/orders/{orderId}/cancel)
- order.confirm: confirm_funded_purchase (POST /v1/orders/{orderId}/confirm)
- order.create: create_vehicle_purchase_order (POST /v1/orders)
- order.fulfill: fulfill_released_purchase (POST /v1/orders/{orderId}/fulfill)
- order.update: annotate_unconfirmed_order (PATCH /v1/orders/{orderId})
- payout.create: pay_marketplace_seller (POST /v1/payouts)
- payout_run.cancel: cancel_creator_payout (POST /v1/payout-runs/{payoutRunId}/cancel)
- payout_run.create: schedule_creator_payout (POST /v1/payout-runs)
- payout_run.withhold: withhold_creator_payout (POST /v1/payout-runs/{payoutRunId}/withhold)
- policy.bind: bind_carrier_accepted_risk (POST /v1/policies/{policyId}/bind)
- policy.cancel: confirm_pre_activation_cancel (POST /v1/policies/{policyId}/cancel)
- policy.create: quote_asset_protection (POST /v1/policies)
- policy.endorse: endorse_extend_active_cover (POST /v1/policies/{policyId}/endorse)
- policy.preview: preview_pre_activation_cancel (POST /v1/policies/{policyId}/preview)
- policy.update: refine_quoted_cover (PATCH /v1/policies/{policyId})
- policy.withdraw: withdraw_unbound_quote (POST /v1/policies/{policyId}/withdraw)
- product.operation_set.retrieve: default (GET /v1/products/{productId}/operation-set)
- product.retrieve: Sandbox Product summary (GET /v1/products/{productId})
- sale_settlement.abandon: abandon_unfunded_sale (POST /v1/sale-settlements/{saleSettlementId}/abandon)
- sale_settlement.cancel: cancel_funded_settlement (POST /v1/sale-settlements/{saleSettlementId}/cancel)
- sale_settlement.collect_service_fee: collect_service_fee (POST /v1/sale-settlements/{saleSettlementId}/collect-service-fee)
- sale_settlement.confirm_handover: confirm_handover_as_buyer (POST /v1/sale-settlements/{saleSettlementId}/confirm-handover)
- sale_settlement.create: open_car_sale_settlement (POST /v1/sale-settlements)
- sale_settlement.fund_piece_1: fund_first_piece (POST /v1/sale-settlements/{saleSettlementId}/fund-piece-1)
- sale_settlement.fund_piece_2: fund_second_piece (POST /v1/sale-settlements/{saleSettlementId}/fund-piece-2)
- sale_settlement.fund_piece_3: fund_third_piece (POST /v1/sale-settlements/{saleSettlementId}/fund-piece-3)
- sale_settlement.refund_piece_2: refund_second_piece (POST /v1/sale-settlements/{saleSettlementId}/refund-piece-2)
- sale_settlement.refund_piece_3: refund_last_piece (POST /v1/sale-settlements/{saleSettlementId}/refund-piece-3)
- sale_settlement.release_piece_2: release_second_piece (POST /v1/sale-settlements/{saleSettlementId}/release-piece-2)
- sale_settlement.release_piece_3: release_last_piece (POST /v1/sale-settlements/{saleSettlementId}/release-piece-3)
- sandbox.account.fund: fund_customer_balance (POST /v1/sandbox/account-funding)
- sandbox.beneficiary.accept: accept_seller_beneficiary (POST /v1/sandbox/beneficiaries/{beneficiaryId}/accept)
- sandbox.customer.onboard: onboard_verified_customer (POST /v1/sandbox/customer-onboarding)
- sandbox.customer_access.activate: activate_onboarded_customer (POST /v1/sandbox/customer-access/{customerAccessId}/activate)
- savings_circle.close: close_finished_circle (POST /v1/savings-circles/{savingsCircleId}/close)
- savings_circle.create: form_family_circle (POST /v1/savings-circles)
- savings_circle.disband: disband_unfilled_circle (POST /v1/savings-circles/{savingsCircleId}/disband)
- subject.create: create_vehicle_subject (POST /v1/subjects)
- subject.create: create_flight_itinerary_subject (POST /v1/subjects)
- subject.create: create_lodging_stay_subject (POST /v1/subjects)
- subject.create: create_merchandise_subject (POST /v1/subjects)
- subject.create: create_policy_risk_subject (POST /v1/subjects)
- subject.create: create_traveler_party_subject (POST /v1/subjects)
- trade_settlement.abandon: abandon_unfunded_trade (POST /v1/trade-settlements/{tradeSettlementId}/abandon)
- trade_settlement.create: open_two_sided_trade (POST /v1/trade-settlements)
- trade_settlement.fund: fund_two_sided_trade (POST /v1/trade-settlements/{tradeSettlementId}/fund)
- trade_settlement.release: release_two_sided_trade (POST /v1/trade-settlements/{tradeSettlementId}/release)
- travel_package.cancel: cancel_booked_package (POST /v1/travel-packages/{travelPackageId}/cancel)
- travel_package.complete: complete_delivered_package (POST /v1/travel-packages/{travelPackageId}/complete)
- travel_package.confirm: book_confirmed_package (POST /v1/travel-packages/{travelPackageId}/confirm)
- travel_package.create: draft_jeddah_getaway (POST /v1/travel-packages)
- trust_requirement.respond: default (POST /v1/trust-requirements/{trustRequirementId}/respond)
- vehicle_escrow.collect_penalty: collect_vehicle_cancel_penalty (POST /v1/vehicle-escrows/{vehicleEscrowId}/collect-penalty)
- vehicle_escrow.confirm_cancel: confirm_vehicle_deposit_cancel (POST /v1/vehicle-escrows/{vehicleEscrowId}/confirm-cancel)
- vehicle_escrow.create: open_vehicle_deposit (POST /v1/vehicle-escrows)
- vehicle_escrow.fund: fund_vehicle_deposit (POST /v1/vehicle-escrows/{vehicleEscrowId}/fund)
- vehicle_escrow.quote_cancel: quote_vehicle_deposit_cancel (POST /v1/vehicle-escrows/{vehicleEscrowId}/quote-cancel)
- vehicle_escrow.release: release_vehicle_deposit (POST /v1/vehicle-escrows/{vehicleEscrowId}/release)
- vehicle_listing.complete: complete_vehicle_sale (POST /v1/vehicle-listings/{vehicleListingId}/complete)
- vehicle_listing.create: list_vehicle_for_sale (POST /v1/vehicle-listings)
- vehicle_listing.delist: delist_unsold_vehicle (POST /v1/vehicle-listings/{vehicleListingId}/delist)
- vehicle_listing.reserve: reserve_funded_vehicle (POST /v1/vehicle-listings/{vehicleListingId}/reserve)
- wallet.activate: activate_member_wallet (POST /v1/wallets/{walletId}/activate)
- wallet.close: close_empty_member_wallet (POST /v1/wallets/{walletId}/close)
- wallet.create: create_member_wallet (POST /v1/wallets)
- wallet.topup: topup_member_wallet (POST /v1/wallets/{walletId}/topup)
- wallet.withdraw: withdraw_member_wallet (POST /v1/wallets/{walletId}/withdraw)
- wallet.withdraw: withdraw_wallet_remainder (POST /v1/wallets/{walletId}/withdraw)
- wallet_spend.create: record_member_spend (POST /v1/wallet-spends)
- wallet_spend.post: post_member_spend (POST /v1/wallet-spends/{walletSpendId}/post)
- wallet_spend.refund: refund_member_spend (POST /v1/wallet-spends/{walletSpendId}/refund)
- webhook.delivery.list: pending_deliveries (GET /v1/webhook-endpoints/{webhookEndpointId}/deliveries)
- webhook.delivery.resend: default (POST /v1/webhook-endpoints/{webhookEndpointId}/deliveries/{webhookDeliveryId}/resend)
- webhook.endpoint.create: default (POST /v1/webhook-endpoints)
- webhook.endpoint.recover: default (POST /v1/webhook-endpoints/{webhookEndpointId}/recover)
- webhook.endpoint.secret.rotate: default (POST /v1/webhook-endpoints/{webhookEndpointId}/secret/rotate)
- webhook.endpoint.update: default (PATCH /v1/webhook-endpoints/{webhookEndpointId})
- admin.billing.platform_rate.clear: clear_pro_collection_rate (POST /v1/admin/platform-rates/{platformRateOverrideId}/clear)
- admin.billing.platform_rate.set: collection_rate (POST /v1/admin/platform-rates)
- admin.product.retrieve: Operator Product summary (GET /v1/admin/products/{productId})
- attribution_queue.list: first_page (GET /v1/internal/attribution-queue)
- beneficiary.activate: activate_beneficiary (POST /v1/beneficiaries/{beneficiaryId}/activate)
- beneficiary.disable: disable_beneficiary (POST /v1/beneficiaries/{beneficiaryId}/disable)
- billing.platform.revenue.account.provision: sandbox_platform_revenue (POST /v1/billing/platform-revenue-account)
- bureau_report.generate: weekly-facility-batch (POST /v1/reporting/bureau-batches)
- card_authorization.expire: expire_uncaptured_authorization (POST /v1/card-authorizations/{cardAuthorizationId}/expire)
- card_dispute.lose: close_unresolved_dispute_at_deadline (POST /v1/card-disputes/{cardDisputeId}/lose)
- catalog.author: publish_captured_payment_catalog (POST /v1/catalog/author)
- circle_membership.activate: activate_seat (POST /v1/circle-memberships/{circleMembershipId}/activate)
- circle_membership.contribute: contribute_monthly (POST /v1/circle-memberships/{circleMembershipId}/contribute)
- circle_membership.receive_pot: receive_pot_in_turn (POST /v1/circle-memberships/{circleMembershipId}/receive-pot)
- circle_membership.withdraw: withdraw_disbanded_seat (POST /v1/circle-memberships/{circleMembershipId}/withdraw)
- composer.catalog: default (GET /v1/composer/catalog)
- composer.check: default (POST /v1/composer/check)
- composer.plan: default (POST /v1/composer/plan)
- consent.grant: marketplace_customer_provider_consent (POST /v1/consents)
- customer.data.export: default (GET /v1/customers/{customerId}/data-export)
- customer.update: default (PATCH /v1/customers/{customerId})
- default_rate_publication.generate: quarterly-publication (POST /v1/reporting/default-rate-publications)
- deposit.record: record_attributed_deposit (POST /v1/deposits)
- deposit.return: return_deposit (POST /v1/deposits/{depositId}/return)
- entity.kyc.submit: saudi_identity_fields (POST /v1/entities/{entityId}/kyc)
- entity.update: default (PATCH /v1/entities/{entityId})
- escrow_order.expire: expire_unfunded_escrow (POST /v1/escrow-orders/{escrowOrderId}/expire)
- financial_address.activate: activate_financial_address (POST /v1/financial-addresses/{financialAddressId}/activate)
- funding_commitment.collect: collect_activated_pledge (POST /v1/funding-commitments/{fundingCommitmentId}/collect)
- funding_commitment.refund: refund_failed_round_pledge (POST /v1/funding-commitments/{fundingCommitmentId}/refund)
- funding_round.activate: activate_funded_round (POST /v1/funding-rounds/{fundingRoundId}/activate)
- funding_round.fail: fail_short_round (POST /v1/funding-rounds/{fundingRoundId}/fail)
- installment.collect: collect_overdue_installment (POST /v1/installments/{installmentId}/collect)
- installment.mark_overdue: mark_installment_overdue (POST /v1/installments/{installmentId}/mark-overdue)
- lender_distribution.payout: pay_lender_distribution (POST /v1/lender-distributions/{lenderDistributionId}/payout)
- listing.expire: expire_stale_offer (POST /v1/listings/{listingId}/expire)
- order.expire: expire_unconfirmed_purchase (POST /v1/orders/{orderId}/expire)
- payout.complete: complete_payout (POST /v1/payouts/{payoutId}/complete)
- payout.fail: fail_payout (POST /v1/payouts/{payoutId}/fail)
- payout.reject: reject_payout_reservation (POST /v1/payouts/{payoutId}/reject)
- payout.reserve: reserve_payout (POST /v1/payouts/{payoutId}/reserve)
- payout.return: return_payout (POST /v1/payouts/{payoutId}/return)
- payout.submit: submit_payout (POST /v1/payouts/{payoutId}/submit)
- payout_run.execute: execute_creator_payout (POST /v1/payout-runs/{payoutRunId}/execute)
- personal_access_token.login_grant.create: default (POST /v1/personal-access-token-login-grants)
- personal_access_token.login_grant.exchange: default (POST /v1/personal-access-token-login-grants/exchange)
- platform.operator.passkey.enrollment.authorize: bootstrap (POST /v1/platform/operators/passkey-enrollment/authorize)
- platform.operator.passkey.enrollment.begin: default (POST /v1/platform/operator/passkeys/enrollment/begin)
- platform.operator.passkey.enrollment.confirm: denied (POST /v1/platform/operator/passkeys/enrollment/confirm)
- platform.operator.passkey.list: default (GET /v1/platform/operator/passkeys)
- platform.operator.passkey.revoke.begin: default (POST /v1/platform/operator/passkeys/{credentialId}/revoke/begin)
- platform.operator.passkey.revoke.confirm: denied (POST /v1/platform/operator/passkeys/revoke/confirm)
- policy.activate: activate_cover_at_start (POST /v1/policies/{policyId}/activate)
- policy.expire: expire_cover_at_term (POST /v1/policies/{policyId}/expire)
- product.blueprint.compose: default (POST /v1/products/blueprint-compose)
- product.build.kit.download: default (POST /v1/products/{productId}/build/kit/downloads)
- product.build.kit.retrieve: default (GET /v1/products/{productId}/build/kit)
- product.build.retrieve: default (GET /v1/products/{productId}/build)
- product.instruments.compose: default (POST /v1/products/instruments-compose)
- product.primitives.create: default (POST /v1/products/primitives-create)
- product.program.relower: default (POST /v1/internal/product-program-relowerings)
- product.recompose: default (POST /v1/products/recompose)
- product.update: default (PATCH /v1/products/{productId})
- reconciliation_break_repair.execute: close_a_bank_fee_break (POST /v1/internal/reconciliation-break-repairs)
- reconciliation_run.execute: reconcile_day (POST /v1/internal/reconciliation-runs)
- safeguarding_report.generate: funded-reconciliation (POST /v1/reporting/safeguarding-reconciliations)
- savings_circle.activate: activate_full_circle (POST /v1/savings-circles/{savingsCircleId}/activate)
- statement.generate: monthly-statement (POST /v1/reporting/statements)
- statement.ingest: ingest_normalized_credit (POST /v1/internal/statements/ingest)
- str_case.advance: advance_to_drafted (POST /v1/internal/str-cases/advance)
- str_case.open: open_case (POST /v1/internal/str-cases)
- subject_kind.create: register_comic_book_kind (POST /v1/subject-kinds)
- support.booking.cancel: default (POST /v1/support/bookings/{bookingId}/cancel)
- support.booking.request: default (POST /v1/support/bookings)
- support.ticket.close: default (POST /v1/support/tickets/{ticketId}/close)
- support.ticket.message.post: default (POST /v1/support/tickets/{ticketId}/messages)
- support.ticket.open: default (POST /v1/support/tickets)
- system.health: healthy release (GET /v1/health)
- system.user.credential.mint: create (POST /v1/system/users/credentials/mint)
- system.user.credential.mint: rotate (POST /v1/system/users/credentials/mint)
- team.member.invite: default (POST /v1/team/members/invite)
- team.member.invite.revoke: default (POST /v1/team/members/invitations/{invitationId}/revoke)
- team.member.list: default (GET /v1/team/members)
- team.member.mfa.reset: default (POST /v1/team/members/{userId}/mfa/reset)
- team.member.remove: default (POST /v1/team/members/{userId}/remove)
- team.member.role.update: default (POST /v1/team/members/{userId}/role)
- team.role.create: default (POST /v1/team/roles)
- team.role.delete: default (POST /v1/team/roles/{roleId}/delete)
- team.role.list: default (GET /v1/team/roles)
- team.role.update: default (POST /v1/team/roles/{roleId})
- tenant.security.configure: default (POST /v1/tenant/security)
- tenant.update: default (PATCH /v1/tenants/{tenantId})
- trade_settlement.post: post_two_sided_trade (POST /v1/trade-settlements/{tradeSettlementId}/post)
- trust_evidence.attach: default (POST /v1/trust-reviews/{trustReviewId}/evidence)
- trust_evidence.external_confirmation.ingest: default (POST /v1/trust-reviews/{trustReviewId}/external-confirmation)
- trust_evidence.external_confirmation.record: default (POST /v1/trust-review-external-confirmation)
- trust_requirement.record: default (POST /v1/trust-requirements)
- trust_requirement.waive: default (POST /v1/trust-requirements/{trustRequirementId}/waive)
- trust_review.cancel: default (POST /v1/trust-reviews/{trustReviewId}/cancel)
- trust_review.create: default (POST /v1/trust-reviews)
- trust_review.create: entity_kyb_review (POST /v1/trust-reviews)
- trust_review.refresh: default (POST /v1/trust-reviews/{trustReviewId}/refresh)
- trust_review.review: default (POST /v1/trust-reviews/{trustReviewId}/review)
- trust_review.submit: default (POST /v1/trust-reviews/{trustReviewId}/submit)
- trust_review_subject.upsert: default (POST /v1/trust-review-subjects)
- unmatched_deposit.list: first_page (GET /v1/internal/unmatched-deposits)
- user.email.verification.confirm: default (POST /v1/identity/email-verification/confirm)
- user.email.verification.request: default (POST /v1/identity/email-verification/request)
- user.login: default (POST /v1/identity/login)
- user.login: mfa-required (POST /v1/identity/login)
- user.login.mfa.verify: default (POST /v1/identity/login/mfa/verify)
- user.login.mfa.verify: denied (POST /v1/identity/login/mfa/verify)
- user.login.passkey.begin: default (POST /v1/identity/login/passkey/begin)
- user.login.passkey.enrollment.begin: default (POST /v1/identity/login/passkey/enrollment/begin)
- user.login.passkey.enrollment.confirm: default (POST /v1/identity/login/passkey/enrollment/confirm)
- user.login.passkey.enrollment.confirm: denied (POST /v1/identity/login/passkey/enrollment/confirm)
- user.login.passkey.verify: default (POST /v1/identity/login/passkey/verify)
- user.login.passkey.verify: denied (POST /v1/identity/login/passkey/verify)
- user.logout: default (POST /v1/identity/logout)
- user.mfa.recovery_codes.list: default (GET /v1/identity/mfa/recovery-codes)
- user.mfa.recovery_codes.regenerate: default (POST /v1/identity/mfa/recovery-codes/regenerate)
- user.mfa.totp.disable: default (POST /v1/identity/mfa/totp/disable)
- user.mfa.totp.disable: denied (POST /v1/identity/mfa/totp/disable)
- user.mfa.totp.enrollment.begin: default (POST /v1/identity/mfa/totp/enrollment/begin)
- user.mfa.totp.enrollment.confirm: default (POST /v1/identity/mfa/totp/enrollment/confirm)
- user.password.reset.confirm: default (POST /v1/identity/password-reset/confirm)
- user.password.reset.confirm: denied (POST /v1/identity/password-reset/confirm)
- user.password.reset.request: default (POST /v1/identity/password-reset/request)
- user.session.list: default (GET /v1/identity/sessions)
- user.session.revoke: default (POST /v1/identity/sessions/{sessionId}/revoke)
- user.signup: default (POST /v1/identity/signup)
- user.signup: invited (POST /v1/identity/signup)
- wedged_money.scan: scan_tenant (GET /v1/internal/wedged-money)
- wedged_money_repair.execute: release_a_stuck_hold (POST /v1/internal/wedged-money-repairs)

## account.create / customer_balance_account

Operation ID: account_create
Route: POST /v1/accounts
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.accountCreate({
  body: {
    owner: {
      type: "customer",
      id: "cus_sandbox_aisha0001",
    },
    role: "customer_balance",
    currency: "SAR",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "owner": {
    "type": "customer",
    "id": "cus_sandbox_aisha0001"
  },
  "role": "customer_balance",
  "currency": "SAR"
}
```

</details>

## account.statement.export / monthly-csv

Operation ID: account_statement_export
Route: GET /v1/accounts/{accountId}/statements/{period}/export
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.accountStatementExport({
  path: {
    accountId: "acct_sandbox_statement0001",
    period: "2026-07",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "accountId": "acct_sandbox_statement0001",
  "closingBalance": "600",
  "contentType": "text/csv",
  "csv": "period,period_start,period_end_exclusive,opening_balance,closing_balance,entry_id,occurred_at,direction,amount,balance_delta,running_balance,currency,status,memo,counterparty_account_id,counterparty_display_name,operation_id,operation_name,instrument_id,instrument_instance_id,action,transfer_id\r\n2026-07,2026-07-01T00:00:00.000Z,2026-08-01T00:00:00.000Z,1000,600,stln_sandbox_statement0001,2026-07-10T09:00:00.000Z,debit,400,-400,600,SAR,posted,sale_settlement sale_sandbox_statement0001 · release_piece_2,acct_sandbox_counterparty0001,ComicDen escrow,ops_sandbox_statement0001,sale_settlement.release_piece_2,sale_settlement,sale_sandbox_statement0001,release_piece_2,trn_sandbox_statement0001\r\n",
  "currency": "SAR",
  "environment": "sandbox",
  "filename": "acct_sandbox_statement0001-2026-07.csv",
  "finalized": true,
  "openingBalance": "1000",
  "period": "2026-07",
  "periodEndExclusive": "2026-08-01T00:00:00.000Z",
  "periodStart": "2026-07-01T00:00:00.000Z",
  "sha256": "5ee0a4198332ad000ddc5c55f6a80d4d04e3bcc554353d9b38a9ab7381b3f4ba",
  "sizeBytes": 698,
  "tenantId": "ten_sandbox_statement0001"
}
```

## beneficiary.create / create_seller_beneficiary

Operation ID: beneficiary_create
Route: POST /v1/beneficiaries
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.beneficiaryCreate({
  body: {
    name: "Sara Al Otaibi",
    accountAddress: "SA8080000000608010167519",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "name": "Sara Al Otaibi",
  "accountAddress": "SA8080000000608010167519"
}
```

</details>

## beneficiary.verify / verify_seller_payout_beneficiary

Operation ID: beneficiary_verify
Route: POST /v1/beneficiary-verifications
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.beneficiaryVerify({
  body: {
    iban: "SA8080000000608010167519",
    beneficiaryName: "Sara Al Otaibi",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "iban": "SA8080000000608010167519",
  "beneficiaryName": "Sara Al Otaibi"
}
```

</details>

### Response

```json
{
  "beneficiaryVerificationId": "bvf_sandbox_seller0001cop1",
  "tenantId": "ten_sandbox_riyadhresale01",
  "iban": "SA8080000000608010167519",
  "beneficiaryName": "Sara Al Otaibi",
  "matchGrade": "full_match"
}
```

## card.activate / activate_virtual_card

Operation ID: card_activate
Route: POST /v1/cards/{cardId}/activate
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardActivate({
  path: {
    cardId: "card_sandbox_virtual00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card.cancel / cancel_virtual_card

Operation ID: card_cancel
Route: POST /v1/cards/{cardId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardCancel({
  path: {
    cardId: "card_sandbox_virtual00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card.create / issue_controlled_virtual_card

Operation ID: card_create
Route: POST /v1/cards
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardCreate({
  body: {
    accountId: "acct_sandbox_cardfund0001",
    cardholderId: "chd_sandbox_customer0001",
    currency: "SAR",
    label: "Primary virtual card",
    productId: "prd_sandbox_cards000001",
    spendControls: {
      allowedCountries: [
        "SA",
      ],
      allowedMerchantCategories: [
        "retail",
        "travel",
        "lodging",
      ],
      dailyLimit: "100000",
      monthlyLimit: "500000",
      singlePurchaseLimit: "50000",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "accountId": "acct_sandbox_cardfund0001",
  "cardholderId": "chd_sandbox_customer0001",
  "currency": "SAR",
  "label": "Primary virtual card",
  "productId": "prd_sandbox_cards000001",
  "spendControls": {
    "allowedCountries": [
      "SA"
    ],
    "allowedMerchantCategories": [
      "retail",
      "travel",
      "lodging"
    ],
    "dailyLimit": "100000",
    "monthlyLimit": "500000",
    "singlePurchaseLimit": "50000"
  }
}
```

</details>

## card.freeze / freeze_virtual_card

Operation ID: card_freeze
Route: POST /v1/cards/{cardId}/freeze
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardFreeze({
  path: {
    cardId: "card_sandbox_virtual00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card.unfreeze / unfreeze_virtual_card

Operation ID: card_unfreeze
Route: POST /v1/cards/{cardId}/unfreeze
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardUnfreeze({
  path: {
    cardId: "card_sandbox_virtual00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card.update / tighten_virtual_card_controls

Operation ID: card_update
Route: PATCH /v1/cards/{cardId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardUpdate({
  path: {
    cardId: "card_sandbox_virtual00001",
  },
  body: {
    label: "Travel card",
    spendControls: {
      allowedCountries: [
        "SA",
        "AE",
      ],
      allowedMerchantCategories: [
        "travel",
        "lodging",
      ],
      dailyLimit: "50000",
      monthlyLimit: "200000",
      singlePurchaseLimit: "25000",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "label": "Travel card",
  "spendControls": {
    "allowedCountries": [
      "SA",
      "AE"
    ],
    "allowedMerchantCategories": [
      "travel",
      "lodging"
    ],
    "dailyLimit": "50000",
    "monthlyLimit": "200000",
    "singlePurchaseLimit": "25000"
  }
}
```

</details>

## card_authorization.approve / approve_authorization_after_jit_decision

Operation ID: card_authorization_approve
Route: POST /v1/card-authorizations/{cardAuthorizationId}/approve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardAuthorizationApprove({
  path: {
    cardAuthorizationId: "cau_sandbox_purchase00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_authorization.capture / capture_completed_purchase

Operation ID: card_authorization_capture
Route: POST /v1/card-authorizations/{cardAuthorizationId}/capture
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardAuthorizationCapture({
  path: {
    cardAuthorizationId: "cau_sandbox_purchase00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_authorization.create / request_retail_authorization

Operation ID: card_authorization_create
Route: POST /v1/card-authorizations
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardAuthorizationCreate({
  body: {
    amount: "12500",
    cardAccountId: "acct_sandbox_cardfund0001",
    cardId: "card_sandbox_virtual00001",
    currency: "SAR",
    expiresAt: "2026-07-16T12:00:00.000Z",
    merchantCategory: "electronics",
    merchantCountry: "SA",
    merchantName: "Riyadh Camera Store",
    merchantReference: "merchant-order-1042",
    productId: "prd_sandbox_cards000001",
    settlementAccountId: "acct_sandbox_merchant0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "12500",
  "cardAccountId": "acct_sandbox_cardfund0001",
  "cardId": "card_sandbox_virtual00001",
  "currency": "SAR",
  "expiresAt": "2026-07-16T12:00:00.000Z",
  "merchantCategory": "electronics",
  "merchantCountry": "SA",
  "merchantName": "Riyadh Camera Store",
  "merchantReference": "merchant-order-1042",
  "productId": "prd_sandbox_cards000001",
  "settlementAccountId": "acct_sandbox_merchant0001"
}
```

</details>

## card_authorization.decline / decline_rejected_authorization

Operation ID: card_authorization_decline
Route: POST /v1/card-authorizations/{cardAuthorizationId}/decline
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardAuthorizationDecline({
  path: {
    cardAuthorizationId: "cau_sandbox_purchase00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_authorization.reverse / reverse_uncaptured_authorization

Operation ID: card_authorization_reverse
Route: POST /v1/card-authorizations/{cardAuthorizationId}/reverse
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardAuthorizationReverse({
  path: {
    cardAuthorizationId: "cau_sandbox_purchase00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_dispute.create / file_unauthorized_purchase_dispute

Operation ID: card_dispute_create
Route: POST /v1/card-disputes
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardDisputeCreate({
  body: {
    cardTransactionId: "ctx_sandbox_purchase00001",
    evidence: [
      {
        kind: "customer_statement",
        reference: "support-case-2048",
        submittedAt: "2026-07-11T10:15:00.000Z",
        summary: "Customer confirms the purchase was not authorized.",
      },
    ],
    productId: "prd_sandbox_cards000001",
    reason: "unauthorized_purchase",
    responseDueAt: "2026-08-10T23:59:59.000Z",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "cardTransactionId": "ctx_sandbox_purchase00001",
  "evidence": [
    {
      "kind": "customer_statement",
      "reference": "support-case-2048",
      "submittedAt": "2026-07-11T10:15:00.000Z",
      "summary": "Customer confirms the purchase was not authorized."
    }
  ],
  "productId": "prd_sandbox_cards000001",
  "reason": "unauthorized_purchase",
  "responseDueAt": "2026-08-10T23:59:59.000Z"
}
```

</details>

## card_dispute.review / begin_card_dispute_review

Operation ID: card_dispute_review
Route: POST /v1/card-disputes/{cardDisputeId}/review
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardDisputeReview({
  path: {
    cardDisputeId: "cdis_sandbox_purchase0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_dispute.update / add_card_dispute_evidence

Operation ID: card_dispute_update
Route: PATCH /v1/card-disputes/{cardDisputeId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardDisputeUpdate({
  path: {
    cardDisputeId: "cdis_sandbox_purchase0001",
  },
  body: {
    evidence: [
      {
        kind: "customer_statement",
        reference: "support-case-2048",
        submittedAt: "2026-07-11T10:15:00.000Z",
        summary: "Customer confirms the purchase was not authorized.",
      },
      {
        kind: "merchant_correspondence",
        submittedAt: "2026-07-12T09:30:00.000Z",
        summary: "Merchant could not produce proof of delivery.",
      },
    ],
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "evidence": [
    {
      "kind": "customer_statement",
      "reference": "support-case-2048",
      "submittedAt": "2026-07-11T10:15:00.000Z",
      "summary": "Customer confirms the purchase was not authorized."
    },
    {
      "kind": "merchant_correspondence",
      "submittedAt": "2026-07-12T09:30:00.000Z",
      "summary": "Merchant could not produce proof of delivery."
    }
  ]
}
```

</details>

## card_dispute.win / return_won_dispute_amount

Operation ID: card_dispute_win
Route: POST /v1/card-disputes/{cardDisputeId}/win
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardDisputeWin({
  path: {
    cardDisputeId: "cdis_sandbox_purchase0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## card_transaction.create / record_captured_card_purchase

Operation ID: card_transaction_create
Route: POST /v1/card-transactions
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardTransactionCreate({
  body: {
    cardAuthorizationId: "cau_sandbox_purchase00001",
    postedAt: "2026-07-10T12:05:00.000Z",
    productId: "prd_sandbox_cards000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "cardAuthorizationId": "cau_sandbox_purchase00001",
  "postedAt": "2026-07-10T12:05:00.000Z",
  "productId": "prd_sandbox_cards000001"
}
```

</details>

## card_transaction.refund / refund_returned_purchase

Operation ID: card_transaction_refund
Route: POST /v1/card-transactions/{cardTransactionId}/refund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardTransactionRefund({
  path: {
    cardTransactionId: "ctx_sandbox_purchase00001",
  },
  body: {
    reason: "Merchant accepted the returned item",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "reason": "Merchant accepted the returned item"
}
```

</details>

## cardholder.activate / activate_approved_cardholder

Operation ID: cardholder_activate
Route: POST /v1/cardholders/{cardholderId}/activate
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderActivate({
  path: {
    cardholderId: "chd_sandbox_customer0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## cardholder.close / close_cardholder_relationship

Operation ID: cardholder_close
Route: POST /v1/cardholders/{cardholderId}/close
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderClose({
  path: {
    cardholderId: "chd_sandbox_customer0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## cardholder.create / create_customer_cardholder

Operation ID: cardholder_create
Route: POST /v1/cardholders
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderCreate({
  body: {
    customerId: "cus_sandbox_customer0001",
    displayName: "Noura Al Saud",
    email: "noura@example.test",
    phoneNumber: "+966500000001",
    productId: "prd_sandbox_cards000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "customerId": "cus_sandbox_customer0001",
  "displayName": "Noura Al Saud",
  "email": "noura@example.test",
  "phoneNumber": "+966500000001",
  "productId": "prd_sandbox_cards000001"
}
```

</details>

## cardholder.resume / resume_cardholder_access

Operation ID: cardholder_resume
Route: POST /v1/cardholders/{cardholderId}/resume
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderResume({
  path: {
    cardholderId: "chd_sandbox_customer0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## cardholder.suspend / suspend_cardholder_access

Operation ID: cardholder_suspend
Route: POST /v1/cardholders/{cardholderId}/suspend
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderSuspend({
  path: {
    cardholderId: "chd_sandbox_customer0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## cardholder.update / update_cardholder_contact

Operation ID: cardholder_update
Route: PATCH /v1/cardholders/{cardholderId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.cardholderUpdate({
  path: {
    cardholderId: "chd_sandbox_customer0001",
  },
  body: {
    displayName: "Noura Al Saud",
    email: "noura@example.test",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "displayName": "Noura Al Saud",
  "email": "noura@example.test"
}
```

</details>

## circle_membership.create / join_family_circle

Operation ID: circle_membership_create
Route: POST /v1/circle-memberships
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.circleMembershipCreate({
  body: {
    joinedAt: "2026-07-25T09:00:00.000Z",
    memberAccountId: "acct_sandbox_member0001",
    payoutAmount: "300000",
    position: 0,
    productId: "prd_sandbox_jamiya00001",
    receiveAt: "2026-08-20T21:00:00.000Z",
    savingsCircleId: "jam_sandbox_alharbi0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "joinedAt": "2026-07-25T09:00:00.000Z",
  "memberAccountId": "acct_sandbox_member0001",
  "payoutAmount": "300000",
  "position": 0,
  "productId": "prd_sandbox_jamiya00001",
  "receiveAt": "2026-08-20T21:00:00.000Z",
  "savingsCircleId": "jam_sandbox_alharbi0001"
}
```

</details>

## circle_membership.create / join_family_circle_second

Operation ID: circle_membership_create
Route: POST /v1/circle-memberships
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.circleMembershipCreate({
  body: {
    joinedAt: "2026-07-25T09:01:00.000Z",
    memberAccountId: "acct_sandbox_member0002",
    payoutAmount: "300000",
    position: 1,
    productId: "prd_sandbox_jamiya00001",
    receiveAt: "2026-09-20T21:00:00.000Z",
    savingsCircleId: "jam_sandbox_alharbi0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "joinedAt": "2026-07-25T09:01:00.000Z",
  "memberAccountId": "acct_sandbox_member0002",
  "payoutAmount": "300000",
  "position": 1,
  "productId": "prd_sandbox_jamiya00001",
  "receiveAt": "2026-09-20T21:00:00.000Z",
  "savingsCircleId": "jam_sandbox_alharbi0001"
}
```

</details>

## circle_membership.create / join_family_circle_third

Operation ID: circle_membership_create
Route: POST /v1/circle-memberships
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.circleMembershipCreate({
  body: {
    joinedAt: "2026-07-25T09:02:00.000Z",
    memberAccountId: "acct_sandbox_member0003",
    payoutAmount: "300000",
    position: 2,
    productId: "prd_sandbox_jamiya00001",
    receiveAt: "2026-10-20T21:00:00.000Z",
    savingsCircleId: "jam_sandbox_alharbi0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "joinedAt": "2026-07-25T09:02:00.000Z",
  "memberAccountId": "acct_sandbox_member0003",
  "payoutAmount": "300000",
  "position": 2,
  "productId": "prd_sandbox_jamiya00001",
  "receiveAt": "2026-10-20T21:00:00.000Z",
  "savingsCircleId": "jam_sandbox_alharbi0001"
}
```

</details>

## claim.approve / approve_assessed_claim

Operation ID: claim_approve
Route: POST /v1/claims/{claimId}/approve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimApprove({
  path: {
    claimId: "clm_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## claim.assess / complete_claim_assessment

Operation ID: claim_assess
Route: POST /v1/claims/{claimId}/assess
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimAssess({
  path: {
    claimId: "clm_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## claim.attest / attest_insurer_approval

Operation ID: claim_attest
Route: POST /v1/claims/{claimId}/attest
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimAttest({
  path: {
    claimId: "clm_sandbox_protection001",
  },
  body: {
    actorAccountId: "acct_sandbox_insurer0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "actorAccountId": "acct_sandbox_insurer0001"
}
```

</details>

## claim.create / file_accidental_damage_claim

Operation ID: claim_create
Route: POST /v1/claims
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimCreate({
  body: {
    claimAmount: "75000",
    claimantAccountId: "acct_sandbox_holder00001",
    currency: "SAR",
    evidenceSummary: "Covered equipment was damaged in an accidental fall.",
    insurerAccountId: "acct_sandbox_insurer0001",
    occurredAt: "2026-10-14T11:30:00.000Z",
    peril: "accidental_damage",
    policyId: "pol_sandbox_protection001",
    productId: "prd_sandbox_protection01",
    subject: "sbj_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "claimAmount": "75000",
  "claimantAccountId": "acct_sandbox_holder00001",
  "currency": "SAR",
  "evidenceSummary": "Covered equipment was damaged in an accidental fall.",
  "insurerAccountId": "acct_sandbox_insurer0001",
  "occurredAt": "2026-10-14T11:30:00.000Z",
  "peril": "accidental_damage",
  "policyId": "pol_sandbox_protection001",
  "productId": "prd_sandbox_protection01",
  "subject": "sbj_sandbox_protection001"
}
```

</details>

## claim.deny / deny_unapproved_claim

Operation ID: claim_deny
Route: POST /v1/claims/{claimId}/deny
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimDeny({
  path: {
    claimId: "clm_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## claim.pay / pay_approved_claim

Operation ID: claim_pay
Route: POST /v1/claims/{claimId}/pay
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimPay({
  path: {
    claimId: "clm_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## claim.reverse / reverse_approved_claim

Operation ID: claim_reverse
Route: POST /v1/claims/{claimId}/reverse
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimReverse({
  path: {
    claimId: "clm_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## claim.update / add_claim_evidence_summary

Operation ID: claim_update
Route: PATCH /v1/claims/{claimId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.claimUpdate({
  path: {
    claimId: "clm_sandbox_protection001",
  },
  body: {
    evidenceSummary: "Damage assessment confirms the covered accidental event.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "evidenceSummary": "Damage assessment confirms the covered accidental event."
}
```

</details>

## collections_case.assign / assign_collections_case

Operation ID: collections_case_assign
Route: POST /v1/collections-cases/{collectionsCaseId}/assign
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.collectionsCaseAssign({
  path: {
    collectionsCaseId: "ccase_sandbox_lending001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## collections_case.create / open_case_for_overdue_installment

Operation ID: collections_case_create
Route: POST /v1/collections-cases
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.collectionsCaseCreate({
  body: {
    agreementId: "cagr_sandbox_lending0001",
    allowedContactEndHour: 20,
    allowedContactStartHour: 9,
    currency: "SAR",
    debtorAccountId: "acct_sandbox_borrower001",
    maxContactAttemptsPer30Days: 6,
    memo: "Third installment 45 days past due; dunning exhausted.",
    productId: "prd_sandbox_lending00001",
    recoveryAccountId: "acct_sandbox_pool000001",
    referredAmount: "450000",
    triggeringInstallmentId: "inst_sandbox_lending0003",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "agreementId": "cagr_sandbox_lending0001",
  "allowedContactEndHour": 20,
  "allowedContactStartHour": 9,
  "currency": "SAR",
  "debtorAccountId": "acct_sandbox_borrower001",
  "maxContactAttemptsPer30Days": 6,
  "memo": "Third installment 45 days past due; dunning exhausted.",
  "productId": "prd_sandbox_lending00001",
  "recoveryAccountId": "acct_sandbox_pool000001",
  "referredAmount": "450000",
  "triggeringInstallmentId": "inst_sandbox_lending0003"
}
```

</details>

## collections_case.recall / recall_collections_case

Operation ID: collections_case_recall
Route: POST /v1/collections-cases/{collectionsCaseId}/recall
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.collectionsCaseRecall({
  path: {
    collectionsCaseId: "ccase_sandbox_lending001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## collections_case.recover / record_lump_sum_recovery

Operation ID: collections_case_recover
Route: POST /v1/collections-cases/{collectionsCaseId}/recover
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.collectionsCaseRecover({
  path: {
    collectionsCaseId: "ccase_sandbox_lending001",
  },
  body: {
    recoveredAmount: "180000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "recoveredAmount": "180000"
}
```

</details>

## contact_attempt.create / record_call_with_promise_to_pay

Operation ID: contact_attempt_create
Route: POST /v1/contact-attempts
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.contactAttemptCreate({
  body: {
    attemptedAt: "2026-07-19T10:30:00.000Z",
    caseId: "ccase_sandbox_lending001",
    channel: "call",
    note: "Debtor committed to a lump-sum payment within two weeks.",
    outcome: "promise_to_pay",
    productId: "prd_sandbox_lending00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "attemptedAt": "2026-07-19T10:30:00.000Z",
  "caseId": "ccase_sandbox_lending001",
  "channel": "call",
  "note": "Debtor committed to a lump-sum payment within two weeks.",
  "outcome": "promise_to_pay",
  "productId": "prd_sandbox_lending00001"
}
```

</details>

## contact_attempt.void / void_contact_attempt

Operation ID: contact_attempt_void
Route: POST /v1/contact-attempts/{contactAttemptId}/void
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.contactAttemptVoid({
  path: {
    contactAttemptId: "catt_sandbox_attempt0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## credit_agreement.advance / advance_credit_agreement

Operation ID: credit_agreement_advance
Route: POST /v1/credit-agreements/{creditAgreementId}/advance
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.creditAgreementAdvance({
  path: {
    creditAgreementId: "cagr_sandbox_lending0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## credit_agreement.create / open_credit_agreement

Operation ID: credit_agreement_create
Route: POST /v1/credit-agreements
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.creditAgreementCreate({
  body: {
    borrowerAccountId: "acct_sandbox_borrower001",
    currency: "SAR",
    fundingAccountId: "acct_sandbox_lender00001",
    principal: "500000",
    productId: "prd_sandbox_lending00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "borrowerAccountId": "acct_sandbox_borrower001",
  "currency": "SAR",
  "fundingAccountId": "acct_sandbox_lender00001",
  "principal": "500000",
  "productId": "prd_sandbox_lending00001"
}
```

</details>

## credit_agreement.settle / settle_credit_agreement

Operation ID: credit_agreement_settle
Route: POST /v1/credit-agreements/{creditAgreementId}/settle
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.creditAgreementSettle({
  path: {
    creditAgreementId: "cagr_sandbox_lending0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## credit_agreement.write_off / write_off_credit_agreement

Operation ID: credit_agreement_write_off
Route: POST /v1/credit-agreements/{creditAgreementId}/write-off
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.creditAgreementWriteOff({
  path: {
    creditAgreementId: "cagr_sandbox_lending0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## customer.create / customer

Operation ID: customer_create
Route: POST /v1/customers
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerCreate({
  body: {
    productId: "prd_sandbox_riyadhresale01",
    entity: {
      kind: "person",
      displayName: "Aisha Al Saud",
      country: "SA",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_riyadhresale01",
  "entity": {
    "kind": "person",
    "displayName": "Aisha Al Saud",
    "country": "SA"
  }
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_aisha0001",
  "customerStatus": "active",
  "entityId": "ent_sandbox_aisha0001",
  "entityStatus": "pending",
  "customerAccessId": "cacc_sandbox_aisha0001"
}
```

## customer.create / organization_customer

Operation ID: customer_create
Route: POST /v1/customers
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerCreate({
  body: {
    productId: "prd_sandbox_riyadhresale01",
    entity: {
      kind: "organization",
      displayName: "Riyadh Creator Studio LLC",
      country: "SA",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_riyadhresale01",
  "entity": {
    "kind": "organization",
    "displayName": "Riyadh Creator Studio LLC",
    "country": "SA"
  }
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_creatorstudio01",
  "customerStatus": "active",
  "entityId": "ent_sandbox_creatorstudio01",
  "entityStatus": "pending",
  "customerAccessId": "cacc_sandbox_creatorstudio01"
}
```

## customer.login / default

Operation ID: customer_login
Route: POST /v1/customer-identity/login
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerLogin({
  body: {
    productId: "prd_sandbox_riyadhresale01",
    email: "aisha@example.com",
    password: "correct-horse-battery",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_riyadhresale01",
  "email": "aisha@example.com",
  "password": "correct-horse-battery"
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_riyadhresale01",
  "environment": "sandbox",
  "customerId": "cus_sandbox_aisha0001",
  "entityId": "ent_sandbox_aisha0001",
  "email": "aisha@example.com",
  "customerAccessId": "cacc_sandbox_aisha0001",
  "customerAccessStatus": "pending",
  "customerSessionId": "csess_sandbox_aisha0001",
  "sessionToken": "hyperscale_cust_00000000000000000000000000000001",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z"
}
```

## customer.logout / default

Operation ID: customer_logout
Route: POST /v1/customer-identity/logout
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerLogout({});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "customerSessionId": "csess_sandbox_aisha0001",
  "status": "revoked",
  "revokedAt": "2026-01-01T00:00:00.000Z"
}
```

## customer.session.revoke / default

Operation ID: customer_session_revoke
Route: POST /v1/customer-identity/sessions/{customerSessionId}/revoke
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerSessionRevoke({
  path: {
    customerSessionId: "csess_sandbox_aisha0002",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "customerSessionId": "csess_sandbox_aisha0002",
  "status": "revoked",
  "revokedAt": "2026-01-02T00:00:00.000Z"
}
```

## customer.signup / default

Operation ID: customer_signup
Route: POST /v1/customer-identity/signup
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.customerSignup({
  body: {
    productId: "prd_sandbox_riyadhresale01",
    email: "aisha@example.com",
    password: "correct-horse-battery",
    displayName: "Aisha Al Saud",
    country: "SA",
    termsAccepted: true,
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_riyadhresale01",
  "email": "aisha@example.com",
  "password": "correct-horse-battery",
  "displayName": "Aisha Al Saud",
  "country": "SA",
  "termsAccepted": true
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_riyadhresale01",
  "environment": "sandbox",
  "customerId": "cus_sandbox_aisha0001",
  "entityId": "ent_sandbox_aisha0001",
  "email": "aisha@example.com",
  "customerAccessId": "cacc_sandbox_aisha0001",
  "customerAccessStatus": "pending",
  "customerSessionId": "csess_sandbox_aisha0001",
  "sessionToken": "hyperscale_cust_00000000000000000000000000000001",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "displayName": "Aisha Al Saud",
  "customerStatus": "active",
  "entityStatus": "pending"
}
```

## deposit_hold.cancel / cancel_security_deposit

Operation ID: deposit_hold_cancel
Route: POST /v1/deposit-holds/{depositHoldId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.depositHoldCancel({
  path: {
    depositHoldId: "dhold_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## deposit_hold.claim / claim_security_deposit

Operation ID: deposit_hold_claim
Route: POST /v1/deposit-holds/{depositHoldId}/claim
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.depositHoldClaim({
  path: {
    depositHoldId: "dhold_sandbox_deposit0001",
  },
  body: {
    actorAccountId: "acct_sandbox_holder00001",
    assessmentNote: "Keep the documented damage amount",
    claimAmount: "20000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "actorAccountId": "acct_sandbox_holder00001",
  "assessmentNote": "Keep the documented damage amount",
  "claimAmount": "20000"
}
```

</details>

## deposit_hold.create / create_security_deposit

Operation ID: deposit_hold_create
Route: POST /v1/deposit-holds
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.depositHoldCreate({
  body: {
    amount: "50000",
    currency: "SAR",
    expiresAt: "2026-12-31T21:00:00.000Z",
    holderAccountId: "acct_sandbox_holder00001",
    memo: "Equipment security deposit",
    payerAccountId: "acct_sandbox_payer000001",
    productId: "prd_sandbox_deposits0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "50000",
  "currency": "SAR",
  "expiresAt": "2026-12-31T21:00:00.000Z",
  "holderAccountId": "acct_sandbox_holder00001",
  "memo": "Equipment security deposit",
  "payerAccountId": "acct_sandbox_payer000001",
  "productId": "prd_sandbox_deposits0001"
}
```

</details>

## deposit_hold.fund / fund_security_deposit

Operation ID: deposit_hold_fund
Route: POST /v1/deposit-holds/{depositHoldId}/fund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.depositHoldFund({
  path: {
    depositHoldId: "dhold_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.cancel / cancel_unfunded_escrow

Operation ID: escrow_order_cancel
Route: POST /v1/escrow-orders/{escrowOrderId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderCancel({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.collect_penalty / collect_disputed_refund_penalty

Operation ID: escrow_order_collect_penalty
Route: POST /v1/escrow-orders/{escrowOrderId}/collect-penalty
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderCollectPenalty({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.create / open_vehicle_escrow

Operation ID: escrow_order_create
Route: POST /v1/escrow-orders
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderCreate({
  body: {
    buyerAccountId: "acct_sandbox_buyer000001",
    fundBy: "2026-08-01T21:00:00.000Z",
    listingId: "lst_sandbox_landcruiser1",
    memo: "Release after the vehicle is handed over.",
    productId: "prd_sandbox_marketplace01",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "buyerAccountId": "acct_sandbox_buyer000001",
  "fundBy": "2026-08-01T21:00:00.000Z",
  "listingId": "lst_sandbox_landcruiser1",
  "memo": "Release after the vehicle is handed over.",
  "productId": "prd_sandbox_marketplace01",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## escrow_order.dispute / hold_funds_for_dispute

Operation ID: escrow_order_dispute
Route: POST /v1/escrow-orders/{escrowOrderId}/dispute
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderDispute({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.fund / fund_purchase_escrow

Operation ID: escrow_order_fund
Route: POST /v1/escrow-orders/{escrowOrderId}/fund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderFund({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.quote / quote_disputed_refund

Operation ID: escrow_order_quote
Route: POST /v1/escrow-orders/{escrowOrderId}/quote
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderQuote({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.refund / confirm_disputed_refund

Operation ID: escrow_order_refund
Route: POST /v1/escrow-orders/{escrowOrderId}/refund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderRefund({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.release / release_escrow

Operation ID: escrow_order_release
Route: POST /v1/escrow-orders/{escrowOrderId}/release
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderRelease({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.resume / resume_after_resolution

Operation ID: escrow_order_resume
Route: POST /v1/escrow-orders/{escrowOrderId}/resume
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderResume({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## escrow_order.update / annotate_unfunded_escrow

Operation ID: escrow_order_update
Route: PATCH /v1/escrow-orders/{escrowOrderId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.escrowOrderUpdate({
  path: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
  body: {
    fundBy: "2026-08-01T21:00:00.000Z",
    memo: "Buyer funds after inspection booking.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "fundBy": "2026-08-01T21:00:00.000Z",
  "memo": "Buyer funds after inspection booking."
}
```

</details>

## event.list / sandbox_events

Operation ID: event_list
Route: GET /v1/events
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.eventList({
  query: {
    limit: 25,
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "items": [
    {
      "id": "aud_sandbox_event0001",
      "object": "event",
      "apiVersion": "2026-06-04",
      "environment": "sandbox",
      "tenantId": "ten_sandbox_riyadhresale01",
      "event": "sale_settlement.piece_3_released",
      "createdAt": "2026-07-22T12:00:00.000Z",
      "operationId": "ops_sandbox_event0001",
      "relatedObject": {
        "id": "sale_sandbox_event0001",
        "type": "instrument_instance"
      },
      "data": {
        "object": {
          "operationName": "sale_settlement.release_piece_3",
          "sourceSurface": "http",
          "status": "released"
        }
      },
      "outbox": {
        "payloadDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
      }
    }
  ]
}
```

## event.retrieve / sandbox_event

Operation ID: event_retrieve
Route: GET /v1/events/{eventId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.eventRetrieve({
  path: {
    eventId: "aud_sandbox_event0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "id": "aud_sandbox_event0001",
  "object": "event",
  "apiVersion": "2026-06-04",
  "environment": "sandbox",
  "tenantId": "ten_sandbox_riyadhresale01",
  "event": "sale_settlement.piece_3_released",
  "createdAt": "2026-07-22T12:00:00.000Z",
  "operationId": "ops_sandbox_event0001",
  "relatedObject": {
    "id": "sale_sandbox_event0001",
    "type": "instrument_instance"
  },
  "data": {
    "object": {
      "operationName": "sale_settlement.release_piece_3",
      "sourceSurface": "http",
      "status": "released"
    }
  },
  "outbox": {
    "payloadDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
  }
}
```

## expected_payment.cancel / cancel_expected_payment

Operation ID: expected_payment_cancel
Route: POST /v1/expected-payments/{expectedPaymentId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.expectedPaymentCancel({
  path: {
    expectedPaymentId: "exp_sandbox_vehicle000001",
  },
  body: {
    reason: "The order was canceled.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "reason": "The order was canceled."
}
```

</details>

## expected_payment.create / expect_vehicle_payment

Operation ID: expected_payment_create
Route: POST /v1/expected-payments
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.expectedPaymentCreate({
  body: {
    productId: "prd_sandbox_marketplace001",
    accountId: "acct_sandbox_seller0001",
    financialAddressId: "faddr_sandbox_customer0001",
    amountMin: "24000",
    amountMax: "26000",
    currency: "SAR",
    windowStart: "2026-07-09T00:00:00.000Z",
    windowEnd: "2026-07-16T00:00:00.000Z",
    reference: "vehicle-order-0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_marketplace001",
  "accountId": "acct_sandbox_seller0001",
  "financialAddressId": "faddr_sandbox_customer0001",
  "amountMin": "24000",
  "amountMax": "26000",
  "currency": "SAR",
  "windowStart": "2026-07-09T00:00:00.000Z",
  "windowEnd": "2026-07-16T00:00:00.000Z",
  "reference": "vehicle-order-0001"
}
```

</details>

## exposure_arrangement.approve / approve_borrower_exposure

Operation ID: exposure_arrangement_approve
Route: POST /v1/exposure-arrangements/{exposureArrangementId}/approve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.exposureArrangementApprove({
  path: {
    exposureArrangementId: "earr_sandbox_exposure001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## exposure_arrangement.close / close_borrower_exposure

Operation ID: exposure_arrangement_close
Route: POST /v1/exposure-arrangements/{exposureArrangementId}/close
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.exposureArrangementClose({
  path: {
    exposureArrangementId: "earr_sandbox_exposure001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## exposure_arrangement.create / open_borrower_exposure

Operation ID: exposure_arrangement_create
Route: POST /v1/exposure-arrangements
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.exposureArrangementCreate({
  body: {
    approvedAmountsCapAmount: "1000000",
    borrowerAccountId: "acct_sandbox_borrower001",
    borrowerEntityId: "borrower-entity-001",
    currency: "SAR",
    productId: "prd_sandbox_lending00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "approvedAmountsCapAmount": "1000000",
  "borrowerAccountId": "acct_sandbox_borrower001",
  "borrowerEntityId": "borrower-entity-001",
  "currency": "SAR",
  "productId": "prd_sandbox_lending00001"
}
```

</details>

## financial_address.create / request_customer_financial_address

Operation ID: financial_address_create
Route: POST /v1/financial-addresses
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.financialAddressCreate({
  body: {
    accountId: "acct_sandbox_customer0001",
    productId: "prd_sandbox_marketplace001",
    purpose: "Customer payments",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "accountId": "acct_sandbox_customer0001",
  "productId": "prd_sandbox_marketplace001",
  "purpose": "Customer payments"
}
```

</details>

## financial_address.disable / disable_financial_address

Operation ID: financial_address_disable
Route: POST /v1/financial-addresses/{financialAddressId}/disable
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.financialAddressDisable({
  path: {
    financialAddressId: "faddr_sandbox_customer0001",
  },
  body: {
    reason: "This address is no longer used.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "reason": "This address is no longer used."
}
```

</details>

## flight_booking.amend_collect / collect_reissued_fare_increase

Operation ID: flight_booking_amend_collect
Route: POST /v1/flight-bookings/{flightBookingId}/amend-collect
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingAmendCollect({
  path: {
    flightBookingId: "fbkg_sandbox_amend0000001",
  },
  body: {
    amendmentNote: "Rebooked SV1024 to the evening departure",
    fareDifference: "24000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentNote": "Rebooked SV1024 to the evening departure",
  "fareDifference": "24000"
}
```

</details>

## flight_booking.amend_fee / collect_reissue_fee

Operation ID: flight_booking_amend_fee
Route: POST /v1/flight-bookings/{flightBookingId}/amend-fee
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingAmendFee({
  path: {
    flightBookingId: "fbkg_sandbox_amend0000001",
  },
  body: {
    amendmentFee: "5000",
    amendmentNote: "Carrier reissue fee for the date change",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentFee": "5000",
  "amendmentNote": "Carrier reissue fee for the date change"
}
```

</details>

## flight_booking.amend_refund / refund_reissued_fare_decrease

Operation ID: flight_booking_amend_refund
Route: POST /v1/flight-bookings/{flightBookingId}/amend-refund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingAmendRefund({
  path: {
    flightBookingId: "fbkg_sandbox_amend0000001",
  },
  body: {
    amendmentNote: "Moved to the lower morning fare",
    fareDifference: "18500",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentNote": "Moved to the lower morning fare",
  "fareDifference": "18500"
}
```

</details>

## flight_booking.cancel_confirm / confirm_flight_cancellation

Operation ID: flight_booking_cancel_confirm
Route: POST /v1/flight-bookings/{flightBookingId}/cancel-confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingCancelConfirm({
  path: {
    flightBookingId: "fbkg_sandbox_flight00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## flight_booking.cancel_quote / quote_flight_cancellation

Operation ID: flight_booking_cancel_quote
Route: POST /v1/flight-bookings/{flightBookingId}/cancel-quote
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingCancelQuote({
  path: {
    flightBookingId: "fbkg_sandbox_flight00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## flight_booking.confirm / confirm_flight_booking

Operation ID: flight_booking_confirm
Route: POST /v1/flight-bookings/{flightBookingId}/confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingConfirm({
  path: {
    flightBookingId: "fbkg_sandbox_flight00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## flight_booking.create / hold_flight_booking

Operation ID: flight_booking_create
Route: POST /v1/flight-bookings
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingCreate({
  body: {
    bookingNote: "Morning flight hold",
    currency: "SAR",
    departsAt: "2026-12-20T06:00:00.000Z",
    fareAmount: "85000",
    holdExpiresAt: "2026-12-10T21:00:00.000Z",
    operatorAccountId: "acct_sandbox_operator0001",
    productId: "prd_sandbox_travel000001",
    subject: "sbj_sandbox_flight000001",
    travelerAccountId: "acct_sandbox_traveler001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "bookingNote": "Morning flight hold",
  "currency": "SAR",
  "departsAt": "2026-12-20T06:00:00.000Z",
  "fareAmount": "85000",
  "holdExpiresAt": "2026-12-10T21:00:00.000Z",
  "operatorAccountId": "acct_sandbox_operator0001",
  "productId": "prd_sandbox_travel000001",
  "subject": "sbj_sandbox_flight000001",
  "travelerAccountId": "acct_sandbox_traveler001"
}
```

</details>

## flight_booking.release / release_flight_booking

Operation ID: flight_booking_release
Route: POST /v1/flight-bookings/{flightBookingId}/release
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.flightBookingRelease({
  path: {
    flightBookingId: "fbkg_sandbox_flight00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## funding_commitment.create / pledge_into_round

Operation ID: funding_commitment_create
Route: POST /v1/funding-commitments
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.fundingCommitmentCreate({
  body: {
    amount: "250000",
    committedAt: "2026-07-20T09:00:00.000Z",
    fundingRoundId: "fnr_sandbox_equipround1",
    investorAccountId: "acct_sandbox_investor01",
    productId: "prd_sandbox_p2pfinance1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "250000",
  "committedAt": "2026-07-20T09:00:00.000Z",
  "fundingRoundId": "fnr_sandbox_equipround1",
  "investorAccountId": "acct_sandbox_investor01",
  "productId": "prd_sandbox_p2pfinance1"
}
```

</details>

## funding_round.close / settle_collected_round

Operation ID: funding_round_close
Route: POST /v1/funding-rounds/{fundingRoundId}/close
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.fundingRoundClose({
  path: {
    fundingRoundId: "fnr_sandbox_equipround1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## funding_round.create / open_equipment_round

Operation ID: funding_round_create
Route: POST /v1/funding-rounds
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.fundingRoundCreate({
  body: {
    borrowerAccountId: "acct_sandbox_borrower001",
    closeBy: "2026-08-15T21:00:00.000Z",
    currency: "SAR",
    memo: "Bakery oven line expansion.",
    productId: "prd_sandbox_p2pfinance1",
    targetAmount: "500000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "borrowerAccountId": "acct_sandbox_borrower001",
  "closeBy": "2026-08-15T21:00:00.000Z",
  "currency": "SAR",
  "memo": "Bakery oven line expansion.",
  "productId": "prd_sandbox_p2pfinance1",
  "targetAmount": "500000"
}
```

</details>

## held_settlement.abandon / abandon_held_settlement

Operation ID: held_settlement_abandon
Route: POST /v1/held-settlements/{heldSettlementId}/abandon
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.heldSettlementAbandon({
  path: {
    heldSettlementId: "held_sandbox_settle00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## held_settlement.create / open_held_settlement

Operation ID: held_settlement_create
Route: POST /v1/held-settlements
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.heldSettlementCreate({
  body: {
    currency: "SAR",
    heldAmount: "75000",
    payeeAccountId: "acct_sandbox_payee00001",
    payerAccountId: "acct_sandbox_payer00001",
    platformAccountId: "acct_sandbox_platform0001",
    productId: "prd_sandbox_settlement01",
    reference: "milestone-001",
    releaseDueAt: "2026-12-31T21:00:00.000Z",
    serviceFeeAmount: "1000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "currency": "SAR",
  "heldAmount": "75000",
  "payeeAccountId": "acct_sandbox_payee00001",
  "payerAccountId": "acct_sandbox_payer00001",
  "platformAccountId": "acct_sandbox_platform0001",
  "productId": "prd_sandbox_settlement01",
  "reference": "milestone-001",
  "releaseDueAt": "2026-12-31T21:00:00.000Z",
  "serviceFeeAmount": "1000"
}
```

</details>

## hotel_stay.amend_collect / collect_extended_stay_increase

Operation ID: hotel_stay_amend_collect
Route: POST /v1/hotel-stays/{hotelStayId}/amend-collect
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayAmendCollect({
  path: {
    hotelStayId: "hstay_sandbox_amend000001",
  },
  body: {
    amendmentNote: "Extended the stay by two nights",
    rateDifference: "32000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentNote": "Extended the stay by two nights",
  "rateDifference": "32000"
}
```

</details>

## hotel_stay.amend_fee / collect_date_change_fee

Operation ID: hotel_stay_amend_fee
Route: POST /v1/hotel-stays/{hotelStayId}/amend-fee
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayAmendFee({
  path: {
    hotelStayId: "hstay_sandbox_amend000001",
  },
  body: {
    amendmentFee: "7500",
    amendmentNote: "Property fee for the date change",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentFee": "7500",
  "amendmentNote": "Property fee for the date change"
}
```

</details>

## hotel_stay.amend_refund / refund_shortened_stay_decrease

Operation ID: hotel_stay_amend_refund
Route: POST /v1/hotel-stays/{hotelStayId}/amend-refund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayAmendRefund({
  path: {
    hotelStayId: "hstay_sandbox_amend000001",
  },
  body: {
    amendmentNote: "Shortened the stay by one night",
    rateDifference: "16000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amendmentNote": "Shortened the stay by one night",
  "rateDifference": "16000"
}
```

</details>

## hotel_stay.cancel_confirm / confirm_weekend_stay_cancel

Operation ID: hotel_stay_cancel_confirm
Route: POST /v1/hotel-stays/{hotelStayId}/cancel-confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayCancelConfirm({
  path: {
    hotelStayId: "hstay_sandbox_weekend0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## hotel_stay.cancel_quote / quote_weekend_stay_cancel

Operation ID: hotel_stay_cancel_quote
Route: POST /v1/hotel-stays/{hotelStayId}/cancel-quote
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayCancelQuote({
  path: {
    hotelStayId: "hstay_sandbox_weekend0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## hotel_stay.confirm / confirm_weekend_stay

Operation ID: hotel_stay_confirm
Route: POST /v1/hotel-stays/{hotelStayId}/confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayConfirm({
  path: {
    hotelStayId: "hstay_sandbox_weekend0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## hotel_stay.create / hold_weekend_stay

Operation ID: hotel_stay_create
Route: POST /v1/hotel-stays
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayCreate({
  body: {
    checkInAt: "2026-10-01T12:00:00.000Z",
    checkOutAt: "2026-10-03T12:00:00.000Z",
    currency: "SAR",
    guestAccountId: "acct_sandbox_guest000001",
    holdExpiresAt: "2026-09-20T12:00:00.000Z",
    productId: "prd_sandbox_travel000001",
    propertyAccountId: "acct_sandbox_property001",
    rateAmount: "50000",
    subject: "sbj_sandbox_stay000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "checkInAt": "2026-10-01T12:00:00.000Z",
  "checkOutAt": "2026-10-03T12:00:00.000Z",
  "currency": "SAR",
  "guestAccountId": "acct_sandbox_guest000001",
  "holdExpiresAt": "2026-09-20T12:00:00.000Z",
  "productId": "prd_sandbox_travel000001",
  "propertyAccountId": "acct_sandbox_property001",
  "rateAmount": "50000",
  "subject": "sbj_sandbox_stay000001"
}
```

</details>

## hotel_stay.release / release_weekend_stay

Operation ID: hotel_stay_release
Route: POST /v1/hotel-stays/{hotelStayId}/release
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.hotelStayRelease({
  path: {
    hotelStayId: "hstay_sandbox_weekend0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## installment.create / schedule_installment

Operation ID: installment_create
Route: POST /v1/installments
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.installmentCreate({
  body: {
    agreementId: "cagr_sandbox_bakery000001",
    amount: "50000",
    borrowerAccountId: "acct_sandbox_borrower001",
    currency: "SAR",
    dueAt: "2026-10-01T12:00:00.000Z",
    fundingAccountId: "acct_sandbox_lenderpool01",
    productId: "prd_sandbox_p2pfinance1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "agreementId": "cagr_sandbox_bakery000001",
  "amount": "50000",
  "borrowerAccountId": "acct_sandbox_borrower001",
  "currency": "SAR",
  "dueAt": "2026-10-01T12:00:00.000Z",
  "fundingAccountId": "acct_sandbox_lenderpool01",
  "productId": "prd_sandbox_p2pfinance1"
}
```

</details>

## installment.write_off / write_off_overdue_installment

Operation ID: installment_write_off
Route: POST /v1/installments/{installmentId}/write-off
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.installmentWriteOff({
  path: {
    installmentId: "inst_sandbox_repayment001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## internal_transfer.create / marketplace_seller_transfer

Operation ID: internal_transfer_create
Route: POST /v1/internal-transfers
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.internalTransferCreate({
  body: {
    sourceAccountId: "acct_sandbox_buyer0001",
    destinationAccountId: "acct_sandbox_seller0001",
    amount: "25000",
    currency: "SAR",
    memo: "Order seller transfer",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "sourceAccountId": "acct_sandbox_buyer0001",
  "destinationAccountId": "acct_sandbox_seller0001",
  "amount": "25000",
  "currency": "SAR",
  "memo": "Order seller transfer"
}
```

</details>

## internal_transfer.post / post_reserved_transfer

Operation ID: internal_transfer_post
Route: POST /v1/internal-transfers/{transferId}/post
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.internalTransferPost({
  path: {
    transferId: "trn_sandbox_reserved0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## internal_transfer.reserve / reserve_account_transfer

Operation ID: internal_transfer_reserve
Route: POST /v1/internal-transfers/reserve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.internalTransferReserve({
  body: {
    sourceAccountId: "acct_sandbox_source0001",
    destinationAccountId: "acct_sandbox_destination1",
    amount: "25000",
    currency: "SAR",
    memo: "Reserve journey transfer",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "sourceAccountId": "acct_sandbox_source0001",
  "destinationAccountId": "acct_sandbox_destination1",
  "amount": "25000",
  "currency": "SAR",
  "memo": "Reserve journey transfer"
}
```

</details>

## internal_transfer.void / void_reserved_transfer

Operation ID: internal_transfer_void
Route: POST /v1/internal-transfers/{transferId}/void
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.internalTransferVoid({
  path: {
    transferId: "trn_sandbox_reserved0001",
  },
  body: {
    reason: "Cancel the reserved journey transfer",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "reason": "Cancel the reserved journey transfer"
}
```

</details>

## lender_distribution.create / claim_lender_distribution

Operation ID: lender_distribution_create
Route: POST /v1/lender-distributions
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.lenderDistributionCreate({
  body: {
    claimedAt: "2026-09-01T12:00:00.000Z",
    creditAgreementId: "cagr_sandbox_bakery000001",
    fundingCommitmentId: "fnc_sandbox_pledge00001",
    fundingRoundId: "fnr_sandbox_equipround1",
    productId: "prd_sandbox_p2pfinance1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "claimedAt": "2026-09-01T12:00:00.000Z",
  "creditAgreementId": "cagr_sandbox_bakery000001",
  "fundingCommitmentId": "fnc_sandbox_pledge00001",
  "fundingRoundId": "fnr_sandbox_equipround1",
  "productId": "prd_sandbox_p2pfinance1"
}
```

</details>

## listing.create / draft_vehicle_offer

Operation ID: listing_create
Route: POST /v1/listings
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingCreate({
  body: {
    askingPrice: "240000",
    currency: "SAR",
    description: "Single owner, full service history, sold under escrow protection.",
    expiresAt: "2026-08-31T21:00:00.000Z",
    headline: "2021 Toyota Land Cruiser GXR",
    imageUrl: "https://cdn.sandbox.example/listings/landcruiser-2021.jpg",
    productId: "prd_sandbox_marketplace01",
    sellerAccountId: "acct_sandbox_seller0001",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "askingPrice": "240000",
  "currency": "SAR",
  "description": "Single owner, full service history, sold under escrow protection.",
  "expiresAt": "2026-08-31T21:00:00.000Z",
  "headline": "2021 Toyota Land Cruiser GXR",
  "imageUrl": "https://cdn.sandbox.example/listings/landcruiser-2021.jpg",
  "productId": "prd_sandbox_marketplace01",
  "sellerAccountId": "acct_sandbox_seller0001",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## listing.publish / publish_vehicle_offer

Operation ID: listing_publish
Route: POST /v1/listings/{listingId}/publish
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingPublish({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## listing.reopen / reopen_refunded_offer

Operation ID: listing_reopen
Route: POST /v1/listings/{listingId}/reopen
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingReopen({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## listing.reserve / reserve_funded_offer

Operation ID: listing_reserve
Route: POST /v1/listings/{listingId}/reserve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingReserve({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
  body: {
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "escrowOrderId": "eord_sandbox_buyerorder01"
}
```

</details>

## listing.sell / sell_funded_offer

Operation ID: listing_sell
Route: POST /v1/listings/{listingId}/sell
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingSell({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## listing.update / attach_funded_escrow

Operation ID: listing_update
Route: PATCH /v1/listings/{listingId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingUpdate({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
  body: {
    askingPrice: "240000",
    escrowOrderId: "eord_sandbox_buyerorder01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "askingPrice": "240000",
  "escrowOrderId": "eord_sandbox_buyerorder01"
}
```

</details>

## listing.withdraw / withdraw_unreserved_offer

Operation ID: listing_withdraw
Route: POST /v1/listings/{listingId}/withdraw
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.listingWithdraw({
  path: {
    listingId: "lst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## motor_policy.bind / bind_vehicle_cover

Operation ID: motor_policy_bind
Route: POST /v1/motor-policies/{motorPolicyId}/bind
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.motorPolicyBind({
  path: {
    motorPolicyId: "mpol_sandbox_cover000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## motor_policy.cancel / cancel_unbound_vehicle_cover

Operation ID: motor_policy_cancel
Route: POST /v1/motor-policies/{motorPolicyId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.motorPolicyCancel({
  path: {
    motorPolicyId: "mpol_sandbox_cover000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## motor_policy.create / quote_vehicle_cover

Operation ID: motor_policy_create
Route: POST /v1/motor-policies
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.motorPolicyCreate({
  body: {
    coverageAmount: "250000",
    coverageDescription: "Comprehensive vehicle cover",
    currency: "SAR",
    expiresAt: "2027-09-01T00:00:00.000Z",
    insurerAccountId: "acct_sandbox_insurer0001",
    policyholderAccountId: "acct_sandbox_buyer000001",
    premiumAmount: "12500",
    productId: "prd_sandbox_marketplace01",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "coverageAmount": "250000",
  "coverageDescription": "Comprehensive vehicle cover",
  "currency": "SAR",
  "expiresAt": "2027-09-01T00:00:00.000Z",
  "insurerAccountId": "acct_sandbox_insurer0001",
  "policyholderAccountId": "acct_sandbox_buyer000001",
  "premiumAmount": "12500",
  "productId": "prd_sandbox_marketplace01",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## order.cancel / cancel_safely_retired_purchase

Operation ID: order_cancel
Route: POST /v1/orders/{orderId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.orderCancel({
  path: {
    orderId: "ord_sandbox_landcruiser01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## order.confirm / confirm_funded_purchase

Operation ID: order_confirm
Route: POST /v1/orders/{orderId}/confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.orderConfirm({
  path: {
    orderId: "ord_sandbox_landcruiser01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## order.create / create_vehicle_purchase_order

Operation ID: order_create
Route: POST /v1/orders
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.orderCreate({
  body: {
    confirmBy: "2026-08-01T20:00:00.000Z",
    escrowOrderId: "eord_sandbox_buyerorder01",
    listingId: "lst_sandbox_landcruiser1",
    memo: "Purchase subject to funded escrow.",
    productId: "prd_sandbox_marketplace01",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "confirmBy": "2026-08-01T20:00:00.000Z",
  "escrowOrderId": "eord_sandbox_buyerorder01",
  "listingId": "lst_sandbox_landcruiser1",
  "memo": "Purchase subject to funded escrow.",
  "productId": "prd_sandbox_marketplace01",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## order.fulfill / fulfill_released_purchase

Operation ID: order_fulfill
Route: POST /v1/orders/{orderId}/fulfill
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.orderFulfill({
  path: {
    orderId: "ord_sandbox_landcruiser01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## order.update / annotate_unconfirmed_order

Operation ID: order_update
Route: PATCH /v1/orders/{orderId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.orderUpdate({
  path: {
    orderId: "ord_sandbox_landcruiser01",
  },
  body: {
    confirmBy: "2026-08-01T20:00:00.000Z",
    memo: "Buyer confirms after inspection.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "confirmBy": "2026-08-01T20:00:00.000Z",
  "memo": "Buyer confirms after inspection."
}
```

</details>

## payout.create / pay_marketplace_seller

Operation ID: payout_create
Route: POST /v1/payouts
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.payoutCreate({
  body: {
    sourceAccountId: "acct_sandbox_seller0001",
    beneficiaryId: "ben_sandbox_seller000001",
    amount: "25000",
    currency: "SAR",
    speed: "standard",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "sourceAccountId": "acct_sandbox_seller0001",
  "beneficiaryId": "ben_sandbox_seller000001",
  "amount": "25000",
  "currency": "SAR",
  "speed": "standard"
}
```

</details>

## payout_run.cancel / cancel_creator_payout

Operation ID: payout_run_cancel
Route: POST /v1/payout-runs/{payoutRunId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.payoutRunCancel({
  path: {
    payoutRunId: "prun_sandbox_creator0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## payout_run.create / schedule_creator_payout

Operation ID: payout_run_create
Route: POST /v1/payout-runs
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.payoutRunCreate({
  body: {
    currency: "SAR",
    earnerAccountId: "acct_sandbox_creator0001",
    netAmount: "90000",
    payoutFundingAccountId: "acct_sandbox_payout00001",
    productId: "prd_sandbox_creator0001",
    runAt: "2026-10-01T12:00:00.000Z",
    withholdingAccountId: "acct_sandbox_tax0000001",
    withholdingAmount: "10000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "currency": "SAR",
  "earnerAccountId": "acct_sandbox_creator0001",
  "netAmount": "90000",
  "payoutFundingAccountId": "acct_sandbox_payout00001",
  "productId": "prd_sandbox_creator0001",
  "runAt": "2026-10-01T12:00:00.000Z",
  "withholdingAccountId": "acct_sandbox_tax0000001",
  "withholdingAmount": "10000"
}
```

</details>

## payout_run.withhold / withhold_creator_payout

Operation ID: payout_run_withhold
Route: POST /v1/payout-runs/{payoutRunId}/withhold
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.payoutRunWithhold({
  path: {
    payoutRunId: "prun_sandbox_creator0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## policy.bind / bind_carrier_accepted_risk

Operation ID: policy_bind
Route: POST /v1/policies/{policyId}/bind
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyBind({
  path: {
    policyId: "pol_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## policy.cancel / confirm_pre_activation_cancel

Operation ID: policy_cancel
Route: POST /v1/policies/{policyId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyCancel({
  path: {
    policyId: "pol_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## policy.create / quote_asset_protection

Operation ID: policy_create
Route: POST /v1/policies
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyCreate({
  body: {
    coverageLimit: "200000",
    currency: "SAR",
    expiresAt: "2027-08-01T00:00:00.000Z",
    insurerAccountId: "acct_sandbox_insurer0001",
    perilSchedule: [
      {
        deductibleBps: 500,
        limitAmount: "200000",
        peril: "accidental_damage",
        waitingPeriodDays: 0,
      },
      {
        deductibleBps: 250,
        limitAmount: "200000",
        peril: "theft",
        waitingPeriodDays: 7,
      },
    ],
    policyholderAccountId: "acct_sandbox_holder00001",
    premiumAmount: "12500",
    productId: "prd_sandbox_protection01",
    startsAt: "2026-08-01T00:00:00.000Z",
    subject: "sbj_sandbox_protection001",
    termsSummary: "Annual cover for accidental damage and theft.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "coverageLimit": "200000",
  "currency": "SAR",
  "expiresAt": "2027-08-01T00:00:00.000Z",
  "insurerAccountId": "acct_sandbox_insurer0001",
  "perilSchedule": [
    {
      "deductibleBps": 500,
      "limitAmount": "200000",
      "peril": "accidental_damage",
      "waitingPeriodDays": 0
    },
    {
      "deductibleBps": 250,
      "limitAmount": "200000",
      "peril": "theft",
      "waitingPeriodDays": 7
    }
  ],
  "policyholderAccountId": "acct_sandbox_holder00001",
  "premiumAmount": "12500",
  "productId": "prd_sandbox_protection01",
  "startsAt": "2026-08-01T00:00:00.000Z",
  "subject": "sbj_sandbox_protection001",
  "termsSummary": "Annual cover for accidental damage and theft."
}
```

</details>

## policy.endorse / endorse_extend_active_cover

Operation ID: policy_endorse
Route: POST /v1/policies/{policyId}/endorse
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyEndorse({
  path: {
    policyId: "pol_sandbox_protection001",
  },
  body: {
    expiresAt: "2027-11-01T00:00:00.000Z",
    termsSummary: "Extended cover incl. water damage.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "expiresAt": "2027-11-01T00:00:00.000Z",
  "termsSummary": "Extended cover incl. water damage."
}
```

</details>

## policy.preview / preview_pre_activation_cancel

Operation ID: policy_preview
Route: POST /v1/policies/{policyId}/preview
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyPreview({
  path: {
    policyId: "pol_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## policy.update / refine_quoted_cover

Operation ID: policy_update
Route: PATCH /v1/policies/{policyId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyUpdate({
  path: {
    policyId: "pol_sandbox_protection001",
  },
  body: {
    perilSchedule: [
      {
        deductibleBps: 500,
        limitAmount: "200000",
        peril: "accidental_damage",
        waitingPeriodDays: 0,
      },
      {
        deductibleBps: 250,
        limitAmount: "200000",
        peril: "theft",
        waitingPeriodDays: 7,
      },
    ],
    termsSummary: "Covers accidental damage and theft.",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "perilSchedule": [
    {
      "deductibleBps": 500,
      "limitAmount": "200000",
      "peril": "accidental_damage",
      "waitingPeriodDays": 0
    },
    {
      "deductibleBps": 250,
      "limitAmount": "200000",
      "peril": "theft",
      "waitingPeriodDays": 7
    }
  ],
  "termsSummary": "Covers accidental damage and theft."
}
```

</details>

## policy.withdraw / withdraw_unbound_quote

Operation ID: policy_withdraw
Route: POST /v1/policies/{policyId}/withdraw
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.policyWithdraw({
  path: {
    policyId: "pol_sandbox_protection001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## product.operation_set.retrieve / default

Operation ID: product_operation_set_retrieve
Route: GET /v1/products/{productId}/operation-set
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.productOperationSetRetrieve({
  path: {
    productId: "prd_sandbox_00000000000000000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "status": "frozen",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "tenantSurfaceVersion": 3,
  "tenantOperationSetDigest": "8bbd5d21c21fbab2b9051ebec508e3b945e2f2f9a299ca5625ee19e037e011d0",
  "publicActions": [
    {
      "name": "openSettlement",
      "instrument": "held_settlement",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      },
      "actorPolicy": {
        "principal": "api_key"
      },
      "portPolicy": {
        "kind": "none"
      },
      "idempotencyPolicy": {
        "mode": "required"
      },
      "receiptPolicy": {
        "type": "held_settlement.created",
        "includeEvidence": true
      },
      "receiptEvidence": {
        "required": []
      }
    }
  ],
  "tenantReadOperationSetDigest": "094c5a503fe0059ad018977c331f9762b02256fd9e3697b4fc0a745894983d60",
  "tenantSetupOperationSetDigest": "a458e40bb318cf50b536c5b1b5e131ebcba2b567f50f6566a334e9404391466d",
  "readOperationIds": [],
  "setupOperationIds": [],
  "setupOperations": [],
  "unresolvedSetupOperationIds": []
}
```

## product.retrieve / Sandbox Product summary

Operation ID: product_retrieve
Route: GET /v1/products/{productId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.productRetrieve({
  path: {
    productId: "prd_sandbox_escrowmarket01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "productId": "prd_sandbox_escrowmarket01",
  "tenantId": "ten_sandbox_founderco01",
  "environment": "sandbox",
  "displayName": "Vehicle Escrow Marketplace",
  "slug": "vehicle-escrow-marketplace",
  "kind": "offering",
  "status": "active",
  "blueprint": {
    "id": "vehicle-escrow-marketplace",
    "name": "Vehicle Escrow Marketplace"
  },
  "instrumentIds": [
    "vehicle_listing",
    "vehicle_escrow"
  ],
  "pricing": {
    "current": {
      "monthlySar": "1000",
      "setupSar": "5000",
      "complexityScore": 0,
      "rates": [],
      "pricingIdentity": "da822dda8add5575b1749bf930b91747f479cfe9bbd4409d45f43aa56fe9e294",
      "priceBasisIdentity": "da822dda8add5575b1749bf930b91747f479cfe9bbd4409d45f43aa56fe9e294"
    },
    "scheduled": null
  },
  "billingBoundaryAt": "2026-10-01T00:00:00.000Z",
  "readiness": {
    "live": false,
    "outstandingLiveRequirements": [
      "bank_letter",
      "live_ledger_partition"
    ],
    "liveUnavailableCapabilities": []
  },
  "capabilities": [
    {
      "capabilityId": "accounts",
      "name": "Accounts"
    }
  ],
  "cost": {
    "currency": "SAR",
    "platformMonthlySar": "1000",
    "platformSetupSar": "5000",
    "liveCapableCount": 0,
    "recurringCharges": [],
    "usageCharges": [],
    "estimatedMonthlyFixedSar": "1000",
    "blockers": [],
    "complete": true
  },
  "surfaces": {
    "graphql": {
      "artifactType": "graphql_schema",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/graphql"
    },
    "mcp": {
      "artifactType": "mcp",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/mcp?capabilityIds=accounts"
    },
    "openapi": {
      "artifactType": "openapi_spec",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/products/prd_sandbox_escrowmarket01/openapi.json"
    },
    "sdk": {
      "artifactType": "sdk_kit",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/products/prd_sandbox_escrowmarket01/kit"
    }
  }
}
```

## sale_settlement.abandon / abandon_unfunded_sale

Operation ID: sale_settlement_abandon
Route: POST /v1/sale-settlements/{saleSettlementId}/abandon
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementAbandon({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## sale_settlement.cancel / cancel_funded_settlement

Operation ID: sale_settlement_cancel
Route: POST /v1/sale-settlements/{saleSettlementId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementCancel({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "cancelPiece1TransferId": "trn_sandbox_cancel000001",
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "cancelling_1",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:35:00.000Z"
}
```

## sale_settlement.collect_service_fee / collect_service_fee

Operation ID: sale_settlement_collect_service_fee
Route: POST /v1/sale-settlements/{saleSettlementId}/collect-service-fee
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementCollectServiceFee({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "funded",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:34:00.000Z"
}
```

## sale_settlement.confirm_handover / confirm_handover_as_buyer

Operation ID: sale_settlement_confirm_handover
Route: POST /v1/sale-settlements/{saleSettlementId}/confirm-handover
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementConfirmHandover({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
  body: {
    actorAccountId: "acct_sandbox_buyer000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "actorAccountId": "acct_sandbox_buyer000001"
}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "releasePiece1TransferId": "trn_sandbox_release00001",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "releasing_1",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:35:00.000Z"
}
```

## sale_settlement.create / open_car_sale_settlement

Operation ID: sale_settlement_create
Route: POST /v1/sale-settlements
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementCreate({
  body: {
    buyerAccountId: "acct_sandbox_buyer000001",
    currency: "SAR",
    piece1Amount: "245000",
    piece2Amount: "3750",
    piece3Amount: "1250",
    platformAccountId: "acct_sandbox_platfees001",
    price: "250000",
    productId: "prd_sandbox_marketplace01",
    sellerAccountId: "acct_sandbox_seller00001",
    serviceFeeAmount: "2500",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "buyerAccountId": "acct_sandbox_buyer000001",
  "currency": "SAR",
  "piece1Amount": "245000",
  "piece2Amount": "3750",
  "piece3Amount": "1250",
  "platformAccountId": "acct_sandbox_platfees001",
  "price": "250000",
  "productId": "prd_sandbox_marketplace01",
  "sellerAccountId": "acct_sandbox_seller00001",
  "serviceFeeAmount": "2500",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "created",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:30:00.000Z"
}
```

## sale_settlement.fund_piece_1 / fund_first_piece

Operation ID: sale_settlement_fund_piece_1
Route: POST /v1/sale-settlements/{saleSettlementId}/fund-piece-1
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementFundPiece1({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "funding_1",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:31:00.000Z"
}
```

## sale_settlement.fund_piece_2 / fund_second_piece

Operation ID: sale_settlement_fund_piece_2
Route: POST /v1/sale-settlements/{saleSettlementId}/fund-piece-2
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementFundPiece2({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "funding_2",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:32:00.000Z"
}
```

## sale_settlement.fund_piece_3 / fund_third_piece

Operation ID: sale_settlement_fund_piece_3
Route: POST /v1/sale-settlements/{saleSettlementId}/fund-piece-3
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementFundPiece3({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "funding_3",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:33:00.000Z"
}
```

## sale_settlement.refund_piece_2 / refund_second_piece

Operation ID: sale_settlement_refund_piece_2
Route: POST /v1/sale-settlements/{saleSettlementId}/refund-piece-2
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementRefundPiece2({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "cancelPiece1TransferId": "trn_sandbox_cancel000001",
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "refundPiece2TransferId": "trn_sandbox_refund000002",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "cancelling_2",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:36:00.000Z"
}
```

## sale_settlement.refund_piece_3 / refund_last_piece

Operation ID: sale_settlement_refund_piece_3
Route: POST /v1/sale-settlements/{saleSettlementId}/refund-piece-3
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementRefundPiece3({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "cancelPiece1TransferId": "trn_sandbox_cancel000001",
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "refundPiece2TransferId": "trn_sandbox_refund000002",
    "refundPiece3TransferId": "trn_sandbox_refund000003",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "cancelled",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:37:00.000Z"
}
```

## sale_settlement.release_piece_2 / release_second_piece

Operation ID: sale_settlement_release_piece_2
Route: POST /v1/sale-settlements/{saleSettlementId}/release-piece-2
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementReleasePiece2({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "releasePiece1TransferId": "trn_sandbox_release00001",
    "releasePiece2TransferId": "trn_sandbox_release00002",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "releasing_2",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:36:00.000Z"
}
```

## sale_settlement.release_piece_3 / release_last_piece

Operation ID: sale_settlement_release_piece_3
Route: POST /v1/sale-settlements/{saleSettlementId}/release-piece-3
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.saleSettlementReleasePiece3({
  path: {
    saleSettlementId: "sale_sandbox_carorder0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "createdAt": "2026-07-20T09:30:00.000Z",
  "fields": {
    "buyerAccountId": "acct_sandbox_buyer000001",
    "currency": "SAR",
    "piece1Amount": "245000",
    "piece2Amount": "3750",
    "piece3Amount": "1250",
    "platformAccountId": "acct_sandbox_platfees001",
    "price": "250000",
    "sellerAccountId": "acct_sandbox_seller00001",
    "serviceFeeAmount": "2500"
  },
  "instrumentId": "sale_settlement",
  "productId": "prd_sandbox_marketplace01",
  "refs": {
    "escrowAccountId": "acct_sandbox_saleescrow1",
    "fundPiece1TransferId": "trn_sandbox_fundpiece001",
    "fundPiece2TransferId": "trn_sandbox_fundpiece002",
    "fundPiece3TransferId": "trn_sandbox_fundpiece003",
    "releasePiece1TransferId": "trn_sandbox_release00001",
    "releasePiece2TransferId": "trn_sandbox_release00002",
    "releasePiece3TransferId": "trn_sandbox_release00003",
    "serviceFeeTransferId": "trn_sandbox_servicefee01",
    "subject": "sbj_sandbox_landcruiser1"
  },
  "saleSettlementId": "sale_sandbox_carorder0001",
  "status": "released",
  "tenantId": "ten_sandbox_riyadhresale01",
  "updatedAt": "2026-07-20T09:37:00.000Z"
}
```

## sandbox.account.fund / fund_customer_balance

Operation ID: sandbox_account_fund
Route: POST /v1/sandbox/account-funding
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.sandboxAccountFund({
  body: {
    destinationAccountId: "acct_sandbox_aisha0001",
    amount: "1000000",
    currency: "SAR",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "destinationAccountId": "acct_sandbox_aisha0001",
  "amount": "1000000",
  "currency": "SAR"
}
```

</details>

## sandbox.beneficiary.accept / accept_seller_beneficiary

Operation ID: sandbox_beneficiary_accept
Route: POST /v1/sandbox/beneficiaries/{beneficiaryId}/accept
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.sandboxBeneficiaryAccept({
  path: {
    beneficiaryId: "ben_sandbox_seller000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## sandbox.customer.onboard / onboard_verified_customer

Operation ID: sandbox_customer_onboard
Route: POST /v1/sandbox/customer-onboarding
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.sandboxCustomerOnboard({
  body: {
    productId: "prd_sandbox_riyadhresale01",
    displayName: "Aisha Al Saud",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_riyadhresale01",
  "displayName": "Aisha Al Saud"
}
```

</details>

## sandbox.customer_access.activate / activate_onboarded_customer

Operation ID: sandbox_customer_access_activate
Route: POST /v1/sandbox/customer-access/{customerAccessId}/activate
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.sandboxCustomerAccessActivate({
  path: {
    customerAccessId: "cacc_sandbox_aisha0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## savings_circle.close / close_finished_circle

Operation ID: savings_circle_close
Route: POST /v1/savings-circles/{savingsCircleId}/close
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.savingsCircleClose({
  path: {
    savingsCircleId: "jam_sandbox_alharbi0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## savings_circle.create / form_family_circle

Operation ID: savings_circle_create
Route: POST /v1/savings-circles
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.savingsCircleCreate({
  body: {
    contributionAmount: "100000",
    currency: "SAR",
    memberCount: 3,
    memo: "Al Harbi family circle, three seats.",
    productId: "prd_sandbox_jamiya00001",
    startAt: "2026-08-01T21:00:00.000Z",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "contributionAmount": "100000",
  "currency": "SAR",
  "memberCount": 3,
  "memo": "Al Harbi family circle, three seats.",
  "productId": "prd_sandbox_jamiya00001",
  "startAt": "2026-08-01T21:00:00.000Z"
}
```

</details>

## savings_circle.disband / disband_unfilled_circle

Operation ID: savings_circle_disband
Route: POST /v1/savings-circles/{savingsCircleId}/disband
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.savingsCircleDisband({
  path: {
    savingsCircleId: "jam_sandbox_alharbi0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## subject.create / create_vehicle_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_marketplace001",
    kind: "vehicle",
    kindVersion: 1,
    attributes: {
      vin: "JTMAB3FV0KD123456",
      make: "Toyota",
      model: "Land Cruiser",
      year: "2024",
      mileageKm: 12000,
    },
    declaredValue: {
      amount: "15000000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_marketplace001",
  "kind": "vehicle",
  "kindVersion": 1,
  "attributes": {
    "vin": "JTMAB3FV0KD123456",
    "make": "Toyota",
    "model": "Land Cruiser",
    "year": "2024",
    "mileageKm": 12000
  },
  "declaredValue": {
    "amount": "15000000",
    "currency": "SAR"
  }
}
```

</details>

### Response

```json
{
  "subjectId": "sbj_sandbox_landcruiser1",
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_marketplace001",
  "kind": "vehicle",
  "kindVersion": 1,
  "attributes": {
    "vin": "JTMAB3FV0KD123456",
    "make": "Toyota",
    "model": "Land Cruiser",
    "year": "2024",
    "mileageKm": 12000
  },
  "declaredValue": {
    "amount": "15000000",
    "currency": "SAR"
  },
  "createdAt": "2026-07-20T09:29:00.000Z",
  "metadata": {}
}
```

## subject.create / create_flight_itinerary_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_travelagency001",
    kind: "flight_itinerary",
    kindVersion: 1,
    attributes: {
      carrierName: "Saudia",
      flightNumber: "SV101",
      origin: "RUH",
      destination: "JED",
      cabin: "economy",
    },
    declaredValue: {
      amount: "125000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_travelagency001",
  "kind": "flight_itinerary",
  "kindVersion": 1,
  "attributes": {
    "carrierName": "Saudia",
    "flightNumber": "SV101",
    "origin": "RUH",
    "destination": "JED",
    "cabin": "economy"
  },
  "declaredValue": {
    "amount": "125000",
    "currency": "SAR"
  }
}
```

</details>

## subject.create / create_lodging_stay_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_travelagency001",
    kind: "lodging_stay",
    kindVersion: 1,
    attributes: {
      propertyName: "Al Faisaliah Hotel",
      city: "Riyadh",
      roomType: "King room",
    },
    declaredValue: {
      amount: "240000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_travelagency001",
  "kind": "lodging_stay",
  "kindVersion": 1,
  "attributes": {
    "propertyName": "Al Faisaliah Hotel",
    "city": "Riyadh",
    "roomType": "King room"
  },
  "declaredValue": {
    "amount": "240000",
    "currency": "SAR"
  }
}
```

</details>

## subject.create / create_merchandise_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_marketplace001",
    kind: "merchandise",
    kindVersion: 1,
    attributes: {
      category: "watch",
      brand: "Rolex",
      model: "Explorer",
      serialNumber: "RX-2026-0001",
      condition: "excellent",
      yearOfManufacture: "2024",
    },
    declaredValue: {
      amount: "3500000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_marketplace001",
  "kind": "merchandise",
  "kindVersion": 1,
  "attributes": {
    "category": "watch",
    "brand": "Rolex",
    "model": "Explorer",
    "serialNumber": "RX-2026-0001",
    "condition": "excellent",
    "yearOfManufacture": "2024"
  },
  "declaredValue": {
    "amount": "3500000",
    "currency": "SAR"
  }
}
```

</details>

## subject.create / create_policy_risk_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_insurance001",
    kind: "policy_risk",
    kindVersion: 1,
    attributes: {
      category: "travel_delay",
      description: "Scheduled trip interruption cover",
      jurisdiction: "SA",
      reference: "TRIP-2026-0001",
    },
    declaredValue: {
      amount: "500000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_insurance001",
  "kind": "policy_risk",
  "kindVersion": 1,
  "attributes": {
    "category": "travel_delay",
    "description": "Scheduled trip interruption cover",
    "jurisdiction": "SA",
    "reference": "TRIP-2026-0001"
  },
  "declaredValue": {
    "amount": "500000",
    "currency": "SAR"
  }
}
```

</details>

## subject.create / create_traveler_party_subject

Operation ID: subject_create
Route: POST /v1/subjects
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.subjectCreate({
  body: {
    productId: "prd_sandbox_travelagency001",
    kind: "traveler_party",
    kindVersion: 1,
    attributes: {
      travelers: [
        {
          role: "self",
          yearOfBirth: 1990,
        },
      ],
      destinationRegion: "GCC",
      originCountry: "SA",
    },
    declaredValue: {
      amount: "800000",
      currency: "SAR",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "productId": "prd_sandbox_travelagency001",
  "kind": "traveler_party",
  "kindVersion": 1,
  "attributes": {
    "travelers": [
      {
        "role": "self",
        "yearOfBirth": 1990
      }
    ],
    "destinationRegion": "GCC",
    "originCountry": "SA"
  },
  "declaredValue": {
    "amount": "800000",
    "currency": "SAR"
  }
}
```

</details>

## trade_settlement.abandon / abandon_unfunded_trade

Operation ID: trade_settlement_abandon
Route: POST /v1/trade-settlements/{tradeSettlementId}/abandon
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.tradeSettlementAbandon({
  path: {
    tradeSettlementId: "trade_sandbox_exchange0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## trade_settlement.create / open_two_sided_trade

Operation ID: trade_settlement_create
Route: POST /v1/trade-settlements
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.tradeSettlementCreate({
  body: {
    currency: "SAR",
    platformAccountId: "acct_sandbox_tradefees01",
    productId: "prd_sandbox_exchange0001",
    sideAAccountId: "acct_sandbox_tradera0001",
    sideAAmount: "100000",
    sideAServiceFeeAmount: "1000",
    sideBAccountId: "acct_sandbox_traderb0001",
    sideBAmount: "85000",
    sideBServiceFeeAmount: "850",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "currency": "SAR",
  "platformAccountId": "acct_sandbox_tradefees01",
  "productId": "prd_sandbox_exchange0001",
  "sideAAccountId": "acct_sandbox_tradera0001",
  "sideAAmount": "100000",
  "sideAServiceFeeAmount": "1000",
  "sideBAccountId": "acct_sandbox_traderb0001",
  "sideBAmount": "85000",
  "sideBServiceFeeAmount": "850"
}
```

</details>

## trade_settlement.fund / fund_two_sided_trade

Operation ID: trade_settlement_fund
Route: POST /v1/trade-settlements/{tradeSettlementId}/fund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.tradeSettlementFund({
  path: {
    tradeSettlementId: "trade_sandbox_exchange0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## trade_settlement.release / release_two_sided_trade

Operation ID: trade_settlement_release
Route: POST /v1/trade-settlements/{tradeSettlementId}/release
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.tradeSettlementRelease({
  path: {
    tradeSettlementId: "trade_sandbox_exchange0001",
  },
  body: {
    actorAccountId: "acct_sandbox_exchangeparty1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "actorAccountId": "acct_sandbox_exchangeparty1"
}
```

</details>

## travel_package.cancel / cancel_booked_package

Operation ID: travel_package_cancel
Route: POST /v1/travel-packages/{travelPackageId}/cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.travelPackageCancel({
  path: {
    travelPackageId: "tpkg_sandbox_getaway00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## travel_package.complete / complete_delivered_package

Operation ID: travel_package_complete
Route: POST /v1/travel-packages/{travelPackageId}/complete
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.travelPackageComplete({
  path: {
    travelPackageId: "tpkg_sandbox_getaway00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## travel_package.confirm / book_confirmed_package

Operation ID: travel_package_confirm
Route: POST /v1/travel-packages/{travelPackageId}/confirm
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.travelPackageConfirm({
  path: {
    travelPackageId: "tpkg_sandbox_getaway00001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## travel_package.create / draft_jeddah_getaway

Operation ID: travel_package_create
Route: POST /v1/travel-packages
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.travelPackageCreate({
  body: {
    departAt: "2026-09-01T21:00:00.000Z",
    memo: "Jeddah corniche long weekend.",
    payerAccountId: "acct_sandbox_traveler0001",
    productId: "prd_sandbox_travel000001",
    subject: "sbj_sandbox_travelparty01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "departAt": "2026-09-01T21:00:00.000Z",
  "memo": "Jeddah corniche long weekend.",
  "payerAccountId": "acct_sandbox_traveler0001",
  "productId": "prd_sandbox_travel000001",
  "subject": "sbj_sandbox_travelparty01"
}
```

</details>

## trust_requirement.respond / default

Operation ID: trust_requirement_respond
Route: POST /v1/trust-requirements/{trustRequirementId}/respond
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.trustRequirementRespond({
  path: {
    trustRequirementId: "vreq_sandbox_bankletter01",
  },
  body: {
    trustReviewId: "vcs_sandbox_livekyb001",
    trustEvidenceId: "vev_sandbox_wathq0001",
    response: "Bank letter uploaded for review.",
    metadata: {
      channel: "product",
    },
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "response": "Bank letter uploaded for review.",
  "metadata": {
    "channel": "product"
  }
}
```

</details>

### Response

```json
{
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "status": "satisfied"
}
```

## vehicle_escrow.collect_penalty / collect_vehicle_cancel_penalty

Operation ID: vehicle_escrow_collect_penalty
Route: POST /v1/vehicle-escrows/{vehicleEscrowId}/collect-penalty
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowCollectPenalty({
  path: {
    vehicleEscrowId: "vesc_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_escrow.confirm_cancel / confirm_vehicle_deposit_cancel

Operation ID: vehicle_escrow_confirm_cancel
Route: POST /v1/vehicle-escrows/{vehicleEscrowId}/confirm-cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowConfirmCancel({
  path: {
    vehicleEscrowId: "vesc_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_escrow.create / open_vehicle_deposit

Operation ID: vehicle_escrow_create
Route: POST /v1/vehicle-escrows
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowCreate({
  body: {
    buyerAccountId: "acct_sandbox_buyer000001",
    currency: "SAR",
    policyId: "mpol_sandbox_cover000001",
    price: "250000",
    productId: "prd_sandbox_marketplace01",
    sellerAccountId: "acct_sandbox_seller00001",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "buyerAccountId": "acct_sandbox_buyer000001",
  "currency": "SAR",
  "policyId": "mpol_sandbox_cover000001",
  "price": "250000",
  "productId": "prd_sandbox_marketplace01",
  "sellerAccountId": "acct_sandbox_seller00001",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## vehicle_escrow.fund / fund_vehicle_deposit

Operation ID: vehicle_escrow_fund
Route: POST /v1/vehicle-escrows/{vehicleEscrowId}/fund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowFund({
  path: {
    vehicleEscrowId: "vesc_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_escrow.quote_cancel / quote_vehicle_deposit_cancel

Operation ID: vehicle_escrow_quote_cancel
Route: POST /v1/vehicle-escrows/{vehicleEscrowId}/quote-cancel
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowQuoteCancel({
  path: {
    vehicleEscrowId: "vesc_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_escrow.release / release_vehicle_deposit

Operation ID: vehicle_escrow_release
Route: POST /v1/vehicle-escrows/{vehicleEscrowId}/release
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleEscrowRelease({
  path: {
    vehicleEscrowId: "vesc_sandbox_deposit0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_listing.complete / complete_vehicle_sale

Operation ID: vehicle_listing_complete
Route: POST /v1/vehicle-listings/{vehicleListingId}/complete
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleListingComplete({
  path: {
    vehicleListingId: "vlst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_listing.create / list_vehicle_for_sale

Operation ID: vehicle_listing_create
Route: POST /v1/vehicle-listings
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleListingCreate({
  body: {
    askingPrice: "250000",
    currency: "SAR",
    headline: "2024 Toyota Land Cruiser",
    productId: "prd_sandbox_marketplace01",
    sellerAccountId: "acct_sandbox_seller00001",
    subject: "sbj_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "askingPrice": "250000",
  "currency": "SAR",
  "headline": "2024 Toyota Land Cruiser",
  "productId": "prd_sandbox_marketplace01",
  "sellerAccountId": "acct_sandbox_seller00001",
  "subject": "sbj_sandbox_landcruiser1"
}
```

</details>

## vehicle_listing.delist / delist_unsold_vehicle

Operation ID: vehicle_listing_delist
Route: POST /v1/vehicle-listings/{vehicleListingId}/delist
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleListingDelist({
  path: {
    vehicleListingId: "vlst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## vehicle_listing.reserve / reserve_funded_vehicle

Operation ID: vehicle_listing_reserve
Route: POST /v1/vehicle-listings/{vehicleListingId}/reserve
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.vehicleListingReserve({
  path: {
    vehicleListingId: "vlst_sandbox_landcruiser1",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## wallet.activate / activate_member_wallet

Operation ID: wallet_activate
Route: POST /v1/wallets/{walletId}/activate
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletActivate({
  path: {
    walletId: "wal_sandbox_member000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## wallet.close / close_empty_member_wallet

Operation ID: wallet_close
Route: POST /v1/wallets/{walletId}/close
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletClose({
  path: {
    walletId: "wal_sandbox_member000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## wallet.create / create_member_wallet

Operation ID: wallet_create
Route: POST /v1/wallets
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletCreate({
  body: {
    currency: "SAR",
    holderAccountId: "acct_sandbox_holder00001",
    limitAmount: "100000",
    productId: "prd_sandbox_wallet000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "currency": "SAR",
  "holderAccountId": "acct_sandbox_holder00001",
  "limitAmount": "100000",
  "productId": "prd_sandbox_wallet000001"
}
```

</details>

## wallet.topup / topup_member_wallet

Operation ID: wallet_topup
Route: POST /v1/wallets/{walletId}/topup
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletTopup({
  path: {
    walletId: "wal_sandbox_member000001",
  },
  body: {
    amount: "50000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "50000"
}
```

</details>

## wallet.withdraw / withdraw_member_wallet

Operation ID: wallet_withdraw
Route: POST /v1/wallets/{walletId}/withdraw
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletWithdraw({
  path: {
    walletId: "wal_sandbox_member000001",
  },
  body: {
    amount: "50000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "50000"
}
```

</details>

## wallet.withdraw / withdraw_wallet_remainder

Operation ID: wallet_withdraw
Route: POST /v1/wallets/{walletId}/withdraw
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletWithdraw({
  path: {
    walletId: "wal_sandbox_member000001",
  },
  body: {
    amount: "35000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "35000"
}
```

</details>

## wallet_spend.create / record_member_spend

Operation ID: wallet_spend_create
Route: POST /v1/wallet-spends
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletSpendCreate({
  body: {
    amount: "15000",
    beneficiaryAccountId: "acct_sandbox_merchant0001",
    productId: "prd_sandbox_wallet000001",
    walletId: "wal_sandbox_member000001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "amount": "15000",
  "beneficiaryAccountId": "acct_sandbox_merchant0001",
  "productId": "prd_sandbox_wallet000001",
  "walletId": "wal_sandbox_member000001"
}
```

</details>

## wallet_spend.post / post_member_spend

Operation ID: wallet_spend_post
Route: POST /v1/wallet-spends/{walletSpendId}/post
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletSpendPost({
  path: {
    walletSpendId: "wspd_sandbox_purchase0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## wallet_spend.refund / refund_member_spend

Operation ID: wallet_spend_refund
Route: POST /v1/wallet-spends/{walletSpendId}/refund
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.walletSpendRefund({
  path: {
    walletSpendId: "wspd_sandbox_purchase0001",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

## webhook.delivery.list / pending_deliveries

Operation ID: webhook_delivery_list
Route: GET /v1/webhook-endpoints/{webhookEndpointId}/deliveries
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookDeliveryList({
  path: {
    webhookEndpointId: "whend_sandbox_receiver01",
  },
  query: {
    status: "pending",
    limit: 25,
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "items": [
    {
      "id": "whdel_sandbox_delivery0001",
      "webhookDeliveryId": "whdel_sandbox_delivery0001",
      "tenantId": "ten_sandbox_riyadhresale01",
      "webhookEndpointId": "whend_sandbox_receiver01",
      "eventId": "aud_sandbox_event0001",
      "eventType": "account.created",
      "attempt": 2,
      "status": "pending",
      "createdAt": "2026-06-04T00:05:00.000Z"
    }
  ]
}
```

## webhook.delivery.resend / default

Operation ID: webhook_delivery_resend
Route: POST /v1/webhook-endpoints/{webhookEndpointId}/deliveries/{webhookDeliveryId}/resend
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookDeliveryResend({
  path: {
    webhookEndpointId: "whend_sandbox_receiver01",
    webhookDeliveryId: "whdel_sandbox_delivery0000",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "webhookEndpointId": "whend_sandbox_receiver01",
  "webhookDeliveryId": "whdel_sandbox_delivery0001",
  "eventId": "aud_sandbox_event0001",
  "eventType": "account.created",
  "attempt": 2,
  "status": "pending",
  "httpStatus": null,
  "responseSnippet": null,
  "nextAttemptAt": null,
  "deliveredAt": null,
  "createdAt": "2026-06-04T00:05:00.000Z"
}
```

## webhook.endpoint.create / default

Operation ID: webhook_endpoint_create
Route: POST /v1/webhook-endpoints
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookEndpointCreate({
  body: {
    url: "https://hooks.example.test/hyperscale",
    enabledEvents: [
      "account.created",
    ],
    description: "Ledger events",
    productId: "prd_sandbox_riyadhresale01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "url": "https://hooks.example.test/hyperscale",
  "enabledEvents": [
    "account.created"
  ],
  "description": "Ledger events",
  "productId": "prd_sandbox_riyadhresale01"
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "webhookEndpointId": "whend_sandbox_receiver01",
  "productId": "prd_sandbox_riyadhresale01",
  "url": "https://hooks.example.test/hyperscale",
  "status": "enabled",
  "audience": "tenant",
  "entityAccountId": null,
  "enabledEvents": [
    "account.created"
  ],
  "secretLast4": "0000",
  "description": "Ledger events",
  "lastDeliveryStatus": null,
  "lastDeliveryAt": null,
  "createdAt": "2026-06-04T00:00:00.000Z",
  "updatedAt": "2026-06-04T00:00:00.000Z",
  "signingSecret": "whsec_example000000000000000000000000000000"
}
```

## webhook.endpoint.recover / default

Operation ID: webhook_endpoint_recover
Route: POST /v1/webhook-endpoints/{webhookEndpointId}/recover
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookEndpointRecover({
  path: {
    webhookEndpointId: "whend_sandbox_receiver01",
  },
  body: {
    since: "2026-06-04T00:00:00.000Z",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "since": "2026-06-04T00:00:00.000Z"
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "webhookEndpointId": "whend_sandbox_receiver01",
  "since": "2026-06-04T00:00:00.000Z",
  "recoveredAt": "2026-06-04T00:05:00.000Z",
  "enqueuedCount": 1,
  "eventIds": [
    "aud_sandbox_event0001"
  ]
}
```

## webhook.endpoint.secret.rotate / default

Operation ID: webhook_endpoint_secret_rotate
Route: POST /v1/webhook-endpoints/{webhookEndpointId}/secret/rotate
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookEndpointSecretRotate({
  path: {
    webhookEndpointId: "whend_sandbox_receiver01",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "webhookEndpointId": "whend_sandbox_receiver01",
  "productId": "prd_sandbox_riyadhresale01",
  "url": "https://hooks.example.test/hyperscale",
  "status": "enabled",
  "audience": "tenant",
  "entityAccountId": null,
  "enabledEvents": [
    "account.created"
  ],
  "secretLast4": "0000",
  "description": "Ledger events",
  "lastDeliveryStatus": null,
  "lastDeliveryAt": null,
  "createdAt": "2026-06-04T00:00:00.000Z",
  "updatedAt": "2026-06-04T00:00:00.000Z",
  "signingSecret": "whsec_rotated000000000000000000000000000000",
  "previousSecretExpiresAt": "2026-06-04T00:05:00.000Z"
}
```

## webhook.endpoint.update / default

Operation ID: webhook_endpoint_update
Route: PATCH /v1/webhook-endpoints/{webhookEndpointId}
Callability: tenant SDK (`sdk=true`)

### Request (TypeScript SDK)

```ts
import { createHyperscale } from "@hyperscale/tenant-sdk-your-capabilities";

const hyperscale = createHyperscale({
  environment: "sandbox",
  auth: () => process.env.HYPERSCALE_API_KEY ?? "",
});

// Replace sample IDs with IDs returned by your Hyperscale setup.

const result = await hyperscale.operations.webhookEndpointUpdate({
  path: {
    webhookEndpointId: "whend_sandbox_receiver01",
  },
  body: {
    url: "https://hooks.example.test/hyperscale-v2",
    reason: "Receiver moved to the v2 ingestion path",
  },
});
```

<details><summary>Raw JSON request body</summary>

```json
{
  "url": "https://hooks.example.test/hyperscale-v2",
  "reason": "Receiver moved to the v2 ingestion path"
}
```

</details>

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "webhookEndpointId": "whend_sandbox_receiver01",
  "productId": "prd_sandbox_riyadhresale01",
  "url": "https://hooks.example.test/hyperscale-v2",
  "status": "enabled",
  "audience": "tenant",
  "entityAccountId": null,
  "enabledEvents": [
    "account.created"
  ],
  "secretLast4": "0000",
  "description": "Ledger events",
  "lastDeliveryStatus": null,
  "lastDeliveryAt": null,
  "createdAt": "2026-06-04T00:00:00.000Z",
  "updatedAt": "2026-06-04T00:05:00.000Z",
  "reason": "Receiver moved to the v2 ingestion path"
}
```

## API-key operations outside the SDK

Every operation below authenticates with an API key, the same credential the SDK snippets use, but sits outside the generated SDK surface (`sdk=false` in the manifest). Call these routes directly over HTTP with the raw JSON shown.

## product.update / default

Operation ID: product_update
Route: PATCH /v1/products/{productId}
Callability: not SDK-callable (`sdk=false`; principal `api_key`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_escrow0001",
  "displayName": "Escrow Marketplace KSA",
  "reason": "Product renamed for the Saudi launch"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_escrow0001",
  "displayName": "Escrow Marketplace KSA",
  "updatedAt": "2026-06-11T12:00:00.000Z",
  "reason": "Product renamed for the Saudi launch"
}
```

## Portal session operations

Every operation below runs as a signed-in portal user (`user_session` principal): the Hyperscale portal calls these routes with a browser session, and they are not callable with an API key. The raw JSON requests are reference material, not SDK programs.

## beneficiary.disable / disable_beneficiary

Operation ID: beneficiary_disable
Route: POST /v1/beneficiaries/{beneficiaryId}/disable
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "beneficiaryId": "ben_sandbox_seller000001"
}
```

## catalog.author / publish_captured_payment_catalog

Operation ID: catalog_author
Route: POST /v1/catalog/author
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "source": "program captured_payment_program \"Captured payment program\"\n\nimport { captured_payment } from \"std/money_flows\"\n\nparty payer: person\nparty payee: business\n\nsettlement captured_payment = captured_payment {\n  payer: payer\n  payee: payee\n  amount: total: money(SAR)\n  reserve_until: reserveUntil\n  correction: port correct_payment\n  external_reversal: port reverse_payment within P120D\n  capture_mode: partial_then_full\n  correction_mode: full_only\n  negative_position: reject\n  timeout: reject\n}\n\nport correct_payment {\n  allowed: [payee]\n}\n\nport reverse_payment {\n  allowed: [payee]\n  shape: { externalReference: text }\n}\n"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "catalogRevisionId": "tcr_sandbox_00000000000000000001",
  "programName": "captured_payment_program",
  "sourceDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "documentDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "overlayDigest": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
  "instrumentIds": [
    "captured_payment"
  ],
  "publicActions": [],
  "warnings": [],
  "status": "published"
}
```

## composer.catalog / default

Operation ID: composer_catalog
Route: GET /v1/composer/catalog
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "operationId": "ops_sandbox_00000000000000000001",
  "receiptId": "rcp_sandbox_00000000000000000001",
  "udl": 1,
  "kernelOperations": [
    "account.escrow.provision",
    "account.freeze",
    "account.unfreeze",
    "internal_transfer.create",
    "internal_transfer.reserve",
    "internal_transfer.post",
    "internal_transfer.void"
  ],
  "decisionCapabilities": [],
  "subjects": [
    {
      "kind": "vehicle",
      "title": "Vehicle",
      "version": 1
    }
  ],
  "instruments": [
    {
      "id": "invoice",
      "idPrefix": "inv",
      "title": "Invoice",
      "summary": "A payable invoice.",
      "dependencies": [],
      "states": [
        "created",
        "paid"
      ],
      "actions": [
        "create",
        "pay"
      ]
    }
  ],
  "blueprints": [
    {
      "id": "vehicle-escrow-marketplace",
      "name": "Vehicle Escrow Marketplace",
      "summary": "Escrowed vehicle sales between buyers and sellers.",
      "instrumentIds": [
        "motor_policy",
        "vehicle_escrow",
        "vehicle_listing"
      ]
    }
  ],
  "document": {
    "udl": 1,
    "product": "commerce_escrow",
    "title": "Commerce and escrow",
    "version": 1,
    "subjects": [],
    "instruments": [
      {
        "actionOrder": [
          "create",
          "pay"
        ],
        "id": "invoice",
        "idPrefix": "inv",
        "title": "Invoice",
        "summary": "A payable invoice.",
        "fields": {
          "amount": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,17}$"
          }
        },
        "required": [
          "amount"
        ],
        "lifecycle": {
          "initial": "created",
          "states": [
            "created",
            "paid"
          ],
          "transitions": {
            "pay": {
              "from": [
                "created"
              ],
              "to": "paid"
            }
          }
        },
        "actions": {
          "create": {
            "steps": [],
            "summary": "Create an invoice."
          },
          "pay": {
            "steps": [],
            "summary": "Mark the invoice paid."
          }
        }
      }
    ]
  }
}
```

## composer.check / default

Operation ID: composer_check
Route: POST /v1/composer/check
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "document": {
    "udl": 1,
    "product": "commerce_escrow",
    "title": "Commerce and escrow",
    "version": 1,
    "subjects": [],
    "instruments": [
      {
        "actionOrder": [
          "create",
          "pay"
        ],
        "id": "invoice",
        "idPrefix": "inv",
        "title": "Invoice",
        "summary": "A payable invoice.",
        "fields": {
          "amount": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,17}$"
          }
        },
        "required": [
          "amount"
        ],
        "lifecycle": {
          "initial": "created",
          "states": [
            "created",
            "paid"
          ],
          "transitions": {
            "pay": {
              "from": [
                "created"
              ],
              "to": "paid"
            }
          }
        },
        "actions": {
          "create": {
            "steps": [],
            "summary": "Create an invoice."
          },
          "pay": {
            "steps": [],
            "summary": "Mark the invoice paid."
          }
        }
      }
    ]
  }
}
```

### Response

```json
{
  "operationId": "ops_sandbox_00000000000000000001",
  "receiptId": "rcp_sandbox_00000000000000000001",
  "ok": true,
  "issues": []
}
```

## composer.plan / default

Operation ID: composer_plan
Route: POST /v1/composer/plan
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "document": {
    "udl": 1,
    "product": "commerce_escrow",
    "title": "Commerce and escrow",
    "version": 1,
    "subjects": [],
    "instruments": [
      {
        "actionOrder": [
          "create",
          "pay"
        ],
        "id": "invoice",
        "idPrefix": "inv",
        "title": "Invoice",
        "summary": "A payable invoice.",
        "fields": {
          "amount": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,17}$"
          }
        },
        "required": [
          "amount"
        ],
        "lifecycle": {
          "initial": "created",
          "states": [
            "created",
            "paid"
          ],
          "transitions": {
            "pay": {
              "from": [
                "created"
              ],
              "to": "paid"
            }
          }
        },
        "actions": {
          "create": {
            "steps": [],
            "summary": "Create an invoice."
          },
          "pay": {
            "steps": [],
            "summary": "Mark the invoice paid."
          }
        }
      }
    ]
  }
}
```

### Response

```json
{
  "operationId": "ops_sandbox_00000000000000000001",
  "receiptId": "rcp_sandbox_00000000000000000001",
  "summary": "1 action(s) require catalog authoring and regeneration; the document is not materializable at runtime.",
  "actions": [
    {
      "kind": "create_instrument",
      "target": "invoice",
      "detail": "invoice is not in the platform instrument catalog; runtime cannot mint instruments, so this requires catalog authoring and regeneration."
    }
  ],
  "pricing": {
    "complexityScore": 5,
    "monthlySar": "2000",
    "activationSar": "10000",
    "current": null,
    "scheduled": null
  }
}
```

## consent.grant / marketplace_customer_provider_consent

Operation ID: consent_grant
Route: POST /v1/consents
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "productId": "prd_sandbox_marketplace01",
  "subjectKind": "customer",
  "subjectId": "cus_sandbox_aisha0001",
  "customerId": "cus_sandbox_aisha0001",
  "providers": [
    "sandbox_bank"
  ],
  "dataCategories": [
    "account_balances",
    "transactions"
  ],
  "version": "2026-01",
  "expiresAt": "2026-12-31T23:59:59.000Z"
}
```

## customer.data.export / default

Operation ID: customer_data_export
Route: GET /v1/customers/{customerId}/data-export
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_aisha0001"
}
```

### Response

```json
{
  "environment": "sandbox",
  "tenantId": "ten_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_aisha0001",
  "generatedAt": "2026-06-11T12:00:00.000Z",
  "customer": {
    "customerId": "cus_sandbox_aisha0001",
    "externalReference": "crm-7741",
    "status": "active",
    "createdAt": "2026-06-01T09:00:00.000Z"
  },
  "entity": {
    "entityId": "ent_sandbox_aisha0001",
    "kind": "person",
    "displayName": "Aisha Al Saud",
    "country": "SA",
    "status": "verified"
  },
  "accessBindings": [
    {
      "customerAccessId": "cacc_sandbox_aisha0001",
      "productId": "prd_sandbox_marketplace01",
      "status": "active",
      "kycStatus": "verified",
      "amlStatus": "clear",
      "metadata": {
        "segment": "retail"
      },
      "evidence": {
        "liveActivation": {
          "source": "admin_review"
        }
      },
      "createdAt": "2026-06-01T09:05:00.000Z"
    }
  ]
}
```

## customer.update / default

Operation ID: customer_update
Route: PATCH /v1/customers/{customerId}
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_aisha0001",
  "externalReference": "crm-7741"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "customerId": "cus_sandbox_aisha0001",
  "externalReference": "crm-7741",
  "status": "active",
  "updatedAt": "2026-06-11T12:00:00.000Z"
}
```

## entity.kyc.submit / saudi_identity_fields

Operation ID: entity_kyc_submit
Route: POST /v1/entities/{entityId}/kyc
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "entityId": "ent_sandbox_aisha0001",
  "fields": {
    "first_name": "Aisha",
    "last_name": "Al Saud",
    "email": "aisha@example.sa",
    "mobile_number": "+966512345678",
    "national_id": "1234567890",
    "birth_month_year": "1992-04",
    "birth_calendar": "gregorian",
    "information_correct_attestation": true
  }
}
```

## entity.update / default

Operation ID: entity_update
Route: PATCH /v1/entities/{entityId}
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "entityId": "ent_sandbox_aisha0001",
  "displayName": "Aisha bint Khalid Al Saud",
  "reason": "Customer corrected legal name during onboarding"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "entityId": "ent_sandbox_aisha0001",
  "displayName": "Aisha bint Khalid Al Saud",
  "country": "SA",
  "status": "pending",
  "updatedAt": "2026-06-11T12:00:00.000Z",
  "reason": "Customer corrected legal name during onboarding"
}
```

## personal_access_token.login_grant.create / default

Operation ID: personal_access_token_login_grant_create
Route: POST /v1/personal-access-token-login-grants
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "name": "Hyperscale CLI"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "loginGrantId": "plg_sandbox_00000000000000000001",
  "grant": "hyperscale_cli_grant_00000000000000000000000000000000",
  "expiresAt": "2030-01-01T00:05:00.000Z"
}
```

## platform.operator.passkey.enrollment.begin / default

Operation ID: admin_platform_operator_passkey_enrollment_begin
Route: POST /v1/platform/operator/passkeys/enrollment/begin
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "label": "MacBook Pro"
}
```

### Response

```json
{
  "challengeId": "pkch_sandbox_000000000000000000000001",
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000001",
  "challengeExpiresAt": "2026-01-01T00:10:00.000Z",
  "creationOptions": {
    "challenge": "Y2hhbGxlbmdl",
    "rp": {
      "id": "hyperscale0.ai",
      "name": "Hyperscale"
    },
    "user": {
      "id": "dXNyX3NhbmRib3g",
      "name": "operator@hyperscale0.ai",
      "displayName": "Platform operator"
    },
    "pubKeyCredParams": [
      {
        "alg": -7,
        "type": "public-key"
      }
    ],
    "authenticatorSelection": {
      "requireResidentKey": true,
      "residentKey": "required",
      "userVerification": "required"
    },
    "attestation": "none"
  }
}
```

## platform.operator.passkey.enrollment.confirm / denied

Operation ID: admin_platform_operator_passkey_enrollment_confirm
Route: POST /v1/platform/operator/passkeys/enrollment/confirm
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000001",
  "registrationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "attestationObject": "ZXhhbXBsZS1hdHRlc3RhdGlvbi1vYmplY3Q"
    },
    "clientExtensionResults": {},
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "denied"
}
```

## platform.operator.passkey.list / default

Operation ID: admin_platform_operator_passkey_list
Route: GET /v1/platform/operator/passkeys
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "items": []
}
```

## platform.operator.passkey.revoke.begin / default

Operation ID: admin_platform_operator_passkey_revoke_begin
Route: POST /v1/platform/operator/passkeys/{credentialId}/revoke/begin
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "credentialId": "Y3JlZGVudGlhbF90YXJnZXQ"
}
```

### Response

```json
{
  "challengeId": "pkch_sandbox_000000000000000000000002",
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000002",
  "challengeExpiresAt": "2026-01-01T00:10:00.000Z",
  "requestOptions": {
    "challenge": "Y2hhbGxlbmdl",
    "rpId": "hyperscale0.ai",
    "allowCredentials": [
      {
        "id": "Y3JlZGVudGlhbF9hdXRoZW50aWNhdG9y",
        "type": "public-key",
        "transports": [
          "internal"
        ]
      }
    ],
    "userVerification": "required"
  }
}
```

## platform.operator.passkey.revoke.confirm / denied

Operation ID: admin_platform_operator_passkey_revoke_confirm
Route: POST /v1/platform/operator/passkeys/revoke/confirm
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000002",
  "authenticationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "authenticatorData": "ZXhhbXBsZS1hdXRoZW50aWNhdG9yLWRhdGE",
      "signature": "ZXhhbXBsZS1zaWduYXR1cmU"
    },
    "clientExtensionResults": {},
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "denied"
}
```

## product.blueprint.compose / default

Operation ID: product_blueprint_compose
Route: POST /v1/products/blueprint-compose
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "blueprintId": "vehicle-escrow-marketplace",
  "name": "Vehicle Escrow Marketplace"
}
```

### Response

```json
{
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "blueprintId": "vehicle-escrow-marketplace",
  "capabilityIds": [
    "accounts",
    "activity",
    "beneficiary_verification",
    "billing",
    "deposits",
    "identity",
    "internal_transfers",
    "motor_policy",
    "payouts",
    "products",
    "usage",
    "vehicle_escrow",
    "vehicle_listing",
    "verification",
    "webhooks"
  ],
  "excludedCapabilityIds": [],
  "buildDigest": "504f2984f4bf9e79e4875fb50f18ae65c9a8d51f8cafedd9f9f463f9363839a7",
  "manifestSchemaVersion": "0.9.0",
  "kind": "app",
  "status": "active",
  "key_delivery": "minted",
  "startKeyId": "key_sandbox_00000000000000000001",
  "shown_once": "hyperscale_00000000000000000000000000000000"
}
```

## product.build.kit.download / default

Operation ID: product_build_kit_download
Route: POST /v1/products/{productId}/build/kit/downloads
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "kitDownloadId": "wkit_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "environment": "sandbox",
  "buildDigest": "504f2984f4bf9e79e4875fb50f18ae65c9a8d51f8cafedd9f9f463f9363839a7",
  "kitManifestVersion": "2.0.0",
  "licenseIdentifier": "LicenseRef-Hyperscale-Proprietary",
  "languages": [
    "typescript",
    "python",
    "go"
  ],
  "archive": {
    "filename": "hyperscale-kit-prd_sandbox_00000000000000000001-32884cb8c6d5e704.zip",
    "format": "zip",
    "sha256": "540316231e1533abf561b3f9efa01ba47e900bdf141ae3a55faedc871c9fece9",
    "sizeBytes": 1048576,
    "url": "/v1/downloads/wkit_sandbox_00000000000000000001",
    "expiresAt": "2026-06-09T13:00:00.000Z"
  }
}
```

## product.build.kit.retrieve / default

Operation ID: product_build_kit_retrieve
Route: GET /v1/products/{productId}/build/kit
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "kitManifestVersion": "2.0.0",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "environment": "sandbox",
  "blueprintId": "vehicle-escrow-marketplace",
  "compositionId": "vehicle-escrow-marketplace",
  "scopeClass": "blueprint",
  "buildDigest": "504f2984f4bf9e79e4875fb50f18ae65c9a8d51f8cafedd9f9f463f9363839a7",
  "manifestSchemaVersion": "0.9.0",
  "provenance": {
    "generator": {
      "name": "@hyperscale/compiler",
      "version": "0.1.0"
    },
    "contractSourceDigest": "a0b28cb73309ec7a73ee76a686b21cbd314027b3103b4d3c7e40855aeee3cd8f",
    "artifactSetDigest": "c48ac4295180be564e850d06d075e1e2c861c12ef7baf2125afa60fbb36c0745",
    "sourceRevision": {
      "commit": "abcdef0",
      "dirty": false
    }
  },
  "capabilityBundleIds": [
    "entity_management",
    "accounts_core",
    "platform_operations"
  ],
  "capabilityIds": [
    "accounts",
    "activity",
    "beneficiary_verification",
    "billing",
    "deposits",
    "identity",
    "internal_transfers",
    "motor_policy",
    "payouts",
    "products",
    "usage",
    "vehicle_escrow",
    "vehicle_listing",
    "verification",
    "webhooks"
  ],
  "sdkLanguages": [
    "typescript",
    "python",
    "go"
  ],
  "operationCount": 103,
  "entries": [
    {
      "path": "sdks/typescript/",
      "kind": "sdk_package",
      "language": "typescript",
      "description": "TypeScript SDK package scoped to this product",
      "sizeBytes": 524288,
      "sha256": "a1064ce481685087f774ffe31e028d9507d261ada0d4311d6eb00e5792d1376c"
    },
    {
      "path": "sdks/python/",
      "kind": "sdk_package",
      "language": "python",
      "description": "Python SDK package scoped to this product",
      "sizeBytes": 458752,
      "sha256": "b3f28560853613fe16469683c6142188261f216d9a5a4d835c6543312d0270f8"
    },
    {
      "path": "sdks/go/",
      "kind": "sdk_package",
      "language": "go",
      "description": "Go SDK module scoped to this product",
      "sizeBytes": 425984,
      "sha256": "179408e9614e80720b13d1c194c39b28db8034ddb59dc3fde656ed878b49e29a"
    },
    {
      "path": "openapi/openapi.json",
      "kind": "openapi_document",
      "description": "OpenAPI document scoped to this product",
      "sizeBytes": 262144,
      "sha256": "6466e6ec9d299ee55a89f9ae0f455bc960d7295ead963490f5497447c2f1feb3"
    },
    {
      "path": "contracts/schemas.json",
      "kind": "contract_schemas",
      "description": "Request and response schemas scoped to this product",
      "sizeBytes": 131072,
      "sha256": "1af9f5927aa1c6df6893b97a3cb1c592470570ee11eae9a8124d584a93e81ad4"
    },
    {
      "path": "graphql/schema.graphql",
      "kind": "graphql",
      "description": "GraphQL schema scoped to this product",
      "sizeBytes": 65536,
      "sha256": "5424116e8713d835fc94a4a0b222638eebf7c61231381c46bee66d6e549855f4"
    },
    {
      "path": "mcp/",
      "kind": "mcp_server",
      "description": "Runnable MCP server scoped to this product",
      "sizeBytes": 262144,
      "sha256": "c0ef54faebbc2f45a2563ea23b4b7cbf74c0b5cbdbfca741cd0a0e94e25a3fab"
    },
    {
      "path": "docs/api-reference.md",
      "kind": "api_reference",
      "description": "API reference for this product",
      "sizeBytes": 98304,
      "sha256": "b1e6394ff90bfe7ea652fe504ea12eae43c8fecaa0090581cb857aa3e014ba5c"
    },
    {
      "path": "docs/sdk-reference.md",
      "kind": "code_documentation",
      "description": "SDK code documentation for the included language packages",
      "sizeBytes": 65536,
      "sha256": "d91dca7aa75ccdc74c958601d0d96e547d7d416d3df1c124876abcdceffbb757"
    },
    {
      "path": "examples/",
      "kind": "usage_examples",
      "description": "Runnable examples for this product",
      "sizeBytes": 49152,
      "sha256": "e763e76efa556abe41b8004d6141fbe4edab286e2770e16e318033ee6254193b"
    },
    {
      "path": "QUICKSTART.md",
      "kind": "quickstart",
      "description": "First-call quickstart for the product's sandbox environment",
      "sizeBytes": 4096,
      "sha256": "147873af8be465c9803fc2026de7840536a18f4e37045ae94bd10ce4e77810d3"
    },
    {
      "path": "docs/setup.md",
      "kind": "setup_instructions",
      "description": "Environment, API-key, and webhook setup instructions",
      "sizeBytes": 8192,
      "sha256": "4ca53116333428d7d34e6d2a9a64069655c8c37d5d36b856320ac1a0c4cb9b23"
    },
    {
      "path": "docs/integration-guide.md",
      "kind": "integration_guide",
      "description": "End-to-end integration guide for this product",
      "sizeBytes": 16384,
      "sha256": "c0c48d2d9bb3d94e663e5058180363262a1b0193aa89d34c18cff0af38227ff2"
    },
    {
      "path": "testing/",
      "kind": "testing_utilities",
      "description": "Sandbox test helpers and webhook verification fixtures",
      "sizeBytes": 24576,
      "sha256": "1d97049bc45fc70938f57921f384c5f5d736864ad9737531bf1f0a6d19d04dd7"
    },
    {
      "path": "scripts/",
      "kind": "build_scripts",
      "description": "Install and build scripts for the included SDK packages",
      "sizeBytes": 2048,
      "sha256": "a3e5b0c952772d5628c96fd5690e62cea1f56648b523ecca58ab5d2d82da382a"
    },
    {
      "path": "product.json",
      "kind": "product_metadata",
      "description": "Product build record snapshot the kit was assembled from",
      "sizeBytes": 1024,
      "sha256": "285888428ebaab4e7985b695829cc9e47f98d2857505070ccacae3432b7b11dc"
    },
    {
      "path": "LICENSE",
      "kind": "license",
      "description": "Hyperscale proprietary, strictly confidential license",
      "sizeBytes": 2048,
      "sha256": "c693279643b8cd5d248172d9c22cb7cf4ed163a3c98c8a3f69c2717edd3eacb7"
    },
    {
      "path": "CONFIDENTIALITY.md",
      "kind": "confidentiality_notice",
      "description": "Strict-confidentiality notice covering every kit artifact",
      "sizeBytes": 1024,
      "sha256": "7b049970f12e00d92137e634bba50a35aa86136f60b9df596638062977a333c9"
    },
    {
      "path": "USAGE-RESTRICTIONS.md",
      "kind": "usage_restrictions",
      "description": "Usage restrictions for the generated artifacts",
      "sizeBytes": 1024,
      "sha256": "15ea0e918a60fc03a4bb1d97707fb15d329c774f014eb4e1d5c7d8f1383ac6ee"
    },
    {
      "path": "sbom.cdx.json",
      "kind": "sbom",
      "description": "CycloneDX software bill of materials for the kit bundle",
      "sizeBytes": 2048,
      "sha256": "dcbfd5da73df887e44388e22a6823438c6153f08105fe1b7460b615513fc3258"
    },
    {
      "path": "kit.attestation.json",
      "kind": "attestation",
      "description": "In-toto provenance attestation binding the kit to its SBOM and source revision",
      "sizeBytes": 2048,
      "sha256": "618699edb3417ebb12eb6662395ff59860e6a240bfe46190666b4511ef2a4b5c"
    }
  ],
  "legal": {
    "licenseIdentifier": "LicenseRef-Hyperscale-Proprietary",
    "license": "LICENSE",
    "confidentialityNotice": "CONFIDENTIALITY.md",
    "usageRestrictions": "USAGE-RESTRICTIONS.md"
  }
}
```

## product.build.retrieve / default

Operation ID: product_build_retrieve
Route: GET /v1/products/{productId}/build
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "environment": "sandbox",
  "blueprintId": "vehicle-escrow-marketplace",
  "capabilityIds": [
    "accounts",
    "activity",
    "beneficiary_verification",
    "billing",
    "deposits",
    "identity",
    "internal_transfers",
    "motor_policy",
    "payouts",
    "products",
    "usage",
    "vehicle_escrow",
    "vehicle_listing",
    "verification",
    "webhooks"
  ],
  "excludedCapabilityIds": [],
  "capabilities": [
    {
      "capabilityId": "accounts",
      "status": "enabled"
    },
    {
      "capabilityId": "activity",
      "status": "enabled"
    },
    {
      "capabilityId": "beneficiary_verification",
      "status": "enabled"
    },
    {
      "capabilityId": "billing",
      "status": "enabled"
    },
    {
      "capabilityId": "deposits",
      "status": "enabled"
    },
    {
      "capabilityId": "identity",
      "status": "enabled"
    },
    {
      "capabilityId": "internal_transfers",
      "status": "enabled"
    },
    {
      "capabilityId": "motor_policy",
      "status": "enabled"
    },
    {
      "capabilityId": "payouts",
      "status": "enabled"
    },
    {
      "capabilityId": "products",
      "status": "enabled"
    },
    {
      "capabilityId": "usage",
      "status": "enabled"
    },
    {
      "capabilityId": "vehicle_escrow",
      "status": "enabled"
    },
    {
      "capabilityId": "vehicle_listing",
      "status": "enabled"
    },
    {
      "capabilityId": "verification",
      "status": "enabled"
    },
    {
      "capabilityId": "webhooks",
      "status": "composed"
    }
  ],
  "buildDigest": "504f2984f4bf9e79e4875fb50f18ae65c9a8d51f8cafedd9f9f463f9363839a7",
  "manifestSchemaVersion": "0.9.0",
  "compositionId": "vehicle-escrow-marketplace",
  "scopeClass": "blueprint",
  "surfaces": {
    "graphql": {
      "artifactType": "graphql_schema",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/graphql"
    },
    "mcp": {
      "artifactType": "mcp",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/mcp?capabilityIds=accounts,activity,beneficiary_verification,billing,deposits,identity,internal_transfers,motor_policy,payouts,products,usage,vehicle_escrow,vehicle_listing,verification,webhooks"
    },
    "openapi": {
      "artifactType": "openapi_spec",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/compose?capabilityIds=accounts,activity,beneficiary_verification,billing,deposits,identity,internal_transfers,motor_policy,payouts,products,usage,vehicle_escrow,vehicle_listing,verification,webhooks"
    },
    "sdk": {
      "artifactType": "sdk_kit",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/compose/sdk?capabilityIds=accounts,activity,beneficiary_verification,billing,deposits,identity,internal_transfers,motor_policy,payouts,products,usage,vehicle_escrow,vehicle_listing,verification,webhooks"
    }
  },
  "createdAt": "2026-06-09T12:00:00.000Z"
}
```

## product.instruments.compose / default

Operation ID: product_instruments_compose
Route: POST /v1/products/instruments-compose
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "instrumentIds": [
    "escrow_order",
    "listing",
    "order"
  ],
  "name": "Escrow Marketplace"
}
```

### Response

```json
{
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "instrumentIds": [
    "escrow_order",
    "listing",
    "order"
  ],
  "capabilityIds": [
    "accounts",
    "activity",
    "billing",
    "escrow_order",
    "identity",
    "internal_transfers",
    "listing",
    "order",
    "products",
    "usage",
    "verification",
    "webhooks"
  ],
  "excludedCapabilityIds": [],
  "buildDigest": "e25dd99347897480ccbac4ea336ee91729144ff8869a9f45b67adc4c5e5b8add",
  "manifestSchemaVersion": "0.9.0",
  "kind": "app",
  "status": "active"
}
```

## product.primitives.create / default

Operation ID: product_primitives_create
Route: POST /v1/products/primitives-create
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "name": "Treasury Primitives"
}
```

### Response

```json
{
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000001",
  "capabilityIds": [
    "accounts",
    "activity",
    "beneficiary_verification",
    "billing",
    "deposits",
    "identity",
    "internal_transfers",
    "payouts",
    "products",
    "usage",
    "verification",
    "webhooks"
  ],
  "excludedCapabilityIds": [],
  "buildDigest": "2df806f22f94f8da509b4b39e6113267ed6d4dafc5e88fda3649effa49736e34",
  "manifestSchemaVersion": "0.9.0",
  "kind": "app",
  "status": "active"
}
```

## product.recompose / default

Operation ID: product_recompose
Route: POST /v1/products/recompose
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "instrumentIds": [
    "escrow_order",
    "listing",
    "order"
  ]
}
```

### Response

```json
{
  "productId": "prd_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000002",
  "instrumentIds": [
    "escrow_order",
    "listing",
    "order"
  ],
  "capabilityIds": [
    "accounts",
    "activity",
    "billing",
    "escrow_order",
    "identity",
    "internal_transfers",
    "listing",
    "order",
    "products",
    "usage",
    "verification",
    "webhooks"
  ],
  "excludedCapabilityIds": [],
  "addedCapabilityIds": [],
  "revokedCapabilityIds": [],
  "buildDigest": "0918ee30ca1da11d9accdfa41adfbccc605f9a9246f2afbe43d4c82070fb8a52",
  "manifestSchemaVersion": "0.9.0",
  "activationReopened": false,
  "outstandingActivationRequirements": [],
  "pricing": {
    "current": {
      "monthlySar": "1000",
      "setupSar": "5000",
      "complexityScore": 0,
      "rates": [],
      "pricingIdentity": "04df36fac2a722a2705872f487b3694e303d506cb1060507ab2cf99a075d4a4c",
      "priceBasisIdentity": "04df36fac2a722a2705872f487b3694e303d506cb1060507ab2cf99a075d4a4c"
    },
    "scheduled": null
  }
}
```

## subject_kind.create / register_comic_book_kind

Operation ID: subject_kind_create
Route: POST /v1/subject-kinds
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_comicden00001",
  "kind": "comic_book",
  "version": 1,
  "title": "Graded comic book",
  "attributesSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "grade",
      "series",
      "issue"
    ],
    "properties": {
      "series": {
        "type": "string"
      },
      "issue": {
        "type": "string"
      },
      "grade": {
        "type": "number"
      },
      "certNumber": {
        "type": "string"
      }
    }
  }
}
```

### Response

```json
{
  "subjectKindId": "skind_sandbox_comicden01",
  "tenantId": "ten_sandbox_comicden00001",
  "kind": "comic_book",
  "version": 1,
  "title": "Graded comic book",
  "attributesSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "grade",
      "series",
      "issue"
    ],
    "properties": {
      "series": {
        "type": "string"
      },
      "issue": {
        "type": "string"
      },
      "grade": {
        "type": "number"
      },
      "certNumber": {
        "type": "string"
      }
    }
  },
  "createdAt": "2026-07-22T10:00:00.000Z"
}
```

## support.booking.cancel / default

Operation ID: support_booking_cancel
Route: POST /v1/support/bookings/{bookingId}/cancel
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "bookingId": "sbok_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "bookingId": "sbok_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "status": "cancelled",
  "updatedAt": "2026-01-02T02:00:00.000Z"
}
```

## support.booking.request / default

Operation ID: support_booking_request
Route: POST /v1/support/bookings
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "topic": "Escrow settlement walkthrough",
  "slotStart": "2026-01-05T07:30:00.000Z"
}
```

### Response

```json
{
  "bookingId": "sbok_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "topic": "Escrow settlement walkthrough",
  "slotStart": "2026-01-05T07:30:00.000Z",
  "slotEnd": "2026-01-05T08:00:00.000Z",
  "status": "requested",
  "requestedByUserId": "usr_sandbox_00000000000000000001",
  "createdAt": "2026-01-02T00:00:00.000Z"
}
```

## support.ticket.close / default

Operation ID: support_ticket_close
Route: POST /v1/support/tickets/{ticketId}/close
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "ticketId": "stkt_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "ticketId": "stkt_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "status": "closed",
  "closedAt": "2026-01-03T00:00:00.000Z"
}
```

## support.ticket.message.post / default

Operation ID: support_ticket_message_post
Route: POST /v1/support/tickets/{ticketId}/messages
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "ticketId": "stkt_sandbox_00000000000000000001",
  "message": "Still failing after the suggested re-enable. Logs attached."
}
```

### Response

```json
{
  "messageId": "stmsg_sandbox_00000000000000000002",
  "ticketId": "stkt_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "status": "waiting_on_support",
  "createdAt": "2026-01-02T01:00:00.000Z"
}
```

## support.ticket.open / default

Operation ID: support_ticket_open
Route: POST /v1/support/tickets
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "kind": "technical",
  "severity": "normal",
  "subject": "Webhook deliveries stopped after key rotation",
  "message": "After rotating our API key this morning, webhook deliveries to our production endpoint stopped. The endpoint itself is healthy."
}
```

### Response

```json
{
  "ticketId": "stkt_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "kind": "technical",
  "severity": "normal",
  "subject": "Webhook deliveries stopped after key rotation",
  "status": "open",
  "openedByUserId": "usr_sandbox_00000000000000000001",
  "messageId": "stmsg_sandbox_00000000000000000001",
  "createdAt": "2026-01-02T00:00:00.000Z"
}
```

## team.member.invite / default

Operation ID: team_member_invite
Route: POST /v1/team/members/invite
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "email": "developer@example.com",
  "role": "developer"
}
```

### Response

```json
{
  "invitationId": "tinv_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "email": "developer@example.com",
  "role": "developer",
  "invitedByUserId": "usr_sandbox_00000000000000000001",
  "inviteToken": "hyperscale_invite_0123456789abcdefghijklmnopqrstuv",
  "expiresAt": "2026-01-08T00:00:00.000Z",
  "status": "pending"
}
```

## team.member.invite.revoke / default

Operation ID: team_member_invite_revoke
Route: POST /v1/team/members/invitations/{invitationId}/revoke
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "invitationId": "tinv_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "invitationId": "tinv_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "email": "developer@example.com",
  "updatedAt": "2026-01-02T00:00:00.000Z",
  "status": "revoked"
}
```

## team.member.list / default

Operation ID: team_member_list
Route: GET /v1/team/members
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "teamId": "team_sandbox_00000000000000000001",
  "members": [
    {
      "membershipId": "tmem_sandbox_00000000000000000001",
      "userId": "usr_sandbox_00000000000000000001",
      "email": "founder@example.com",
      "displayName": "Founder Example",
      "role": "owner",
      "status": "active",
      "joinedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "invitations": [
    {
      "invitationId": "tinv_sandbox_00000000000000000001",
      "email": "developer@example.com",
      "role": "developer",
      "invitedByUserId": "usr_sandbox_00000000000000000001",
      "expiresAt": "2026-01-08T00:00:00.000Z",
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}
```

## team.member.mfa.reset / default

Operation ID: team_member_mfa_reset
Route: POST /v1/team/members/{userId}/mfa/reset
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002",
  "status": "reset",
  "resetAt": "2026-01-01T00:00:00.000Z",
  "sessionsRevoked": 2,
  "mfaEnrollmentRequired": true
}
```

## team.member.remove / default

Operation ID: team_member_remove
Route: POST /v1/team/members/{userId}/remove
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002"
}
```

### Response

```json
{
  "membershipId": "tmem_sandbox_00000000000000000002",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002",
  "role": "developer",
  "sessionsRevoked": 1,
  "removedAt": "2026-01-02T00:00:00.000Z"
}
```

## team.member.role.update / default

Operation ID: team_member_role_update
Route: POST /v1/team/members/{userId}/role
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002",
  "role": "admin"
}
```

### Response

```json
{
  "membershipId": "tmem_sandbox_00000000000000000002",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000002",
  "previousRole": "developer",
  "role": "admin",
  "sessionsRevoked": 1,
  "updatedAt": "2026-01-02T00:00:00.000Z"
}
```

## team.role.create / default

Operation ID: team_role_create
Route: POST /v1/team/roles
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "name": "Payments desk",
  "permissions": [
    "desk.billing",
    "desk.invoices",
    "desk.treasury",
    "desk.treasury.withdraw"
  ]
}
```

### Response

```json
{
  "roleId": "trole_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "name": "Payments desk",
  "permissions": [
    "desk.billing",
    "desk.invoices",
    "desk.treasury",
    "desk.treasury.withdraw"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z"
}
```

## team.role.delete / default

Operation ID: team_role_delete
Route: POST /v1/team/roles/{roleId}/delete
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "roleId": "trole_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "roleId": "trole_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "name": "Payments desk",
  "deletedAt": "2026-01-03T00:00:00.000Z"
}
```

## team.role.list / default

Operation ID: team_role_list
Route: GET /v1/team/roles
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "teamId": "team_sandbox_00000000000000000001",
  "roles": [
    {
      "roleId": "trole_sandbox_00000000000000000001",
      "name": "Payments desk",
      "permissions": [
        "desk.billing",
        "desk.invoices",
        "desk.treasury",
        "desk.treasury.withdraw"
      ],
      "memberCount": 2,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}
```

## team.role.update / default

Operation ID: team_role_update
Route: POST /v1/team/roles/{roleId}
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "roleId": "trole_sandbox_00000000000000000001",
  "permissions": [
    "desk.billing",
    "desk.invoices",
    "desk.treasury",
    "desk.treasury.withdraw",
    "desk.usage"
  ]
}
```

### Response

```json
{
  "roleId": "trole_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "name": "Payments desk",
  "permissions": [
    "desk.billing",
    "desk.invoices",
    "desk.treasury",
    "desk.treasury.withdraw",
    "desk.usage"
  ],
  "sessionsRevoked": 2,
  "updatedAt": "2026-01-02T00:00:00.000Z"
}
```

## tenant.security.configure / default

Operation ID: tenant_security_configure
Route: POST /v1/tenant/security
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "requireMfa": true
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "requireMfa": true,
  "updatedAt": "2026-01-02T00:00:00.000Z"
}
```

## tenant.update / default

Operation ID: tenant_update
Route: PATCH /v1/tenants/{tenantId}
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "legalName": "Riyadh Resale Trading Co",
  "reason": "Legal name updated after re-registration"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "legalName": "Riyadh Resale Trading Co",
  "updatedAt": "2026-06-11T12:00:00.000Z",
  "reason": "Legal name updated after re-registration"
}
```

## trust_evidence.attach / default

Operation ID: trust_evidence_attach
Route: POST /v1/trust-reviews/{trustReviewId}/evidence
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "kind": "document_upload",
  "documentReference": "doc_sandbox_bankletter01",
  "documentType": "bank_letter",
  "checksum": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "checksumAlgorithm": "sha256",
  "filename": "bank-letter.pdf",
  "mimeType": "application/pdf",
  "byteSize": 48219,
  "metadata": {
    "uploadedBy": "ops"
  }
}
```

### Response

```json
{
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "kind": "document_upload",
  "documentType": "bank_letter",
  "checksum": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "checksumAlgorithm": "sha256"
}
```

## trust_review.create / default

Operation ID: trust_review_create
Route: POST /v1/trust-reviews
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "target": {
    "type": "tenant",
    "id": "ten_sandbox_riyadhresale01"
  },
  "productId": "prd_sandbox_default001",
  "subjectEntityId": "ent_sandbox_riyadhresale01",
  "businessIdentity": {
    "country": "SA",
    "commercialRegistration": {
      "number": "1010123456",
      "legalName": "Riyadh Resale Trading LLC",
      "unifiedNationalNumber": "7001234567",
      "legalForm": "limited_liability_company",
      "declaredCapital": {
        "amount": "100000000",
        "currency": "SAR"
      }
    },
    "vat": {
      "registrationNumber": "300000000000003"
    },
    "nationalAddress": {
      "shortAddress": "RRRD2929",
      "buildingNumber": "2929",
      "postalCode": "11564",
      "city": "Riyadh"
    }
  },
  "moneyFlowModel": {
    "fundsIn": "customer_to_platform",
    "fundsHeld": true,
    "fundsOut": "platform_to_customer",
    "settlementTarget": "tenant_account",
    "expectedMonthlyVolume": "100000000",
    "expectedMonthlyTransactionCount": 500,
    "sourceOfFunds": [
      "customer_payments"
    ],
    "useCases": [
      "accounts",
      "payouts"
    ],
    "counterpartyCountries": [
      "SA"
    ]
  }
}
```

### Response

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "target": {
    "type": "tenant",
    "id": "ten_sandbox_riyadhresale01"
  },
  "productId": "prd_sandbox_default001",
  "businessIdentity": {
    "country": "SA",
    "commercialRegistration": {
      "number": "1010123456",
      "legalName": "Riyadh Resale Trading LLC",
      "unifiedNationalNumber": "7001234567",
      "legalForm": "limited_liability_company",
      "declaredCapital": {
        "amount": "100000000",
        "currency": "SAR"
      }
    },
    "vat": {
      "registrationNumber": "300000000000003"
    },
    "nationalAddress": {
      "shortAddress": "RRRD2929",
      "buildingNumber": "2929",
      "postalCode": "11564",
      "city": "Riyadh"
    }
  },
  "moneyFlowModel": {
    "fundsIn": "customer_to_platform",
    "fundsHeld": true,
    "fundsOut": "platform_to_customer",
    "settlementTarget": "tenant_account",
    "expectedMonthlyVolume": "100000000",
    "expectedMonthlyTransactionCount": 500,
    "sourceOfFunds": [
      "customer_payments"
    ],
    "useCases": [
      "accounts",
      "payouts"
    ],
    "counterpartyCountries": [
      "SA"
    ]
  },
  "status": "draft"
}
```

## trust_review.create / entity_kyb_review

Operation ID: trust_review_create
Route: POST /v1/trust-reviews
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "target": {
    "type": "entity",
    "id": "ent_sandbox_riyadhresale01"
  }
}
```

### Response

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "target": {
    "type": "entity",
    "id": "ent_sandbox_riyadhresale01"
  },
  "status": "draft"
}
```

## trust_review.submit / default

Operation ID: trust_review_submit
Route: POST /v1/trust-reviews/{trustReviewId}/submit
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "submittedAt": "2026-05-22T09:00:00.000Z"
}
```

### Response

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "status": "submitted"
}
```

## user.email.verification.request / default

Operation ID: user_email_verification_request
Route: POST /v1/identity/email-verification/request
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "status": "accepted"
}
```

## user.logout / default

Operation ID: user_logout
Route: POST /v1/identity/logout
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "sessionId": "sess_sandbox_00000000000000000001",
  "status": "revoked",
  "revokedAt": "2026-01-01T00:00:00.000Z"
}
```

## user.mfa.recovery_codes.list / default

Operation ID: user_mfa_recovery_codes_list
Route: GET /v1/identity/mfa/recovery-codes
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "remainingCount": 10
}
```

## user.mfa.recovery_codes.regenerate / default

Operation ID: user_mfa_recovery_codes_regenerate
Route: POST /v1/identity/mfa/recovery-codes/regenerate
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "factorId": "umf_sandbox_00000000000000000001",
  "remainingCount": 10,
  "recoveryCodes": [
    "00000000-00000000-00000000-00000001",
    "00000000-00000000-00000000-00000002",
    "00000000-00000000-00000000-00000003",
    "00000000-00000000-00000000-00000004",
    "00000000-00000000-00000000-00000005",
    "00000000-00000000-00000000-00000006",
    "00000000-00000000-00000000-00000007",
    "00000000-00000000-00000000-00000008",
    "00000000-00000000-00000000-00000009",
    "00000000-00000000-00000000-00000010"
  ]
}
```

## user.mfa.totp.disable / default

Operation ID: user_mfa_totp_disable
Route: POST /v1/identity/mfa/totp/disable
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "code": "287082"
}
```

### Response

```json
{
  "factorId": "umf_sandbox_00000000000000000001",
  "status": "disabled",
  "disabledAt": "2026-01-01T00:00:00.000Z",
  "sessionsRevoked": 2
}
```

## user.mfa.totp.disable / denied

Operation ID: user_mfa_totp_disable
Route: POST /v1/identity/mfa/totp/disable
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "code": "000000"
}
```

### Response

```json
{
  "status": "denied",
  "attemptsRemaining": 4
}
```

## user.mfa.totp.enrollment.begin / default

Operation ID: user_mfa_totp_enrollment_begin
Route: POST /v1/identity/mfa/totp/enrollment/begin
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{}
```

### Response

```json
{
  "factorId": "umf_sandbox_00000000000000000001",
  "otpauthUri": "otpauth://totp/Hyperscale%3Afounder%40example.com?algorithm=SHA1&digits=6&issuer=Hyperscale&period=30&secret=GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ",
  "status": "pending"
}
```

## user.mfa.totp.enrollment.confirm / default

Operation ID: user_mfa_totp_enrollment_confirm
Route: POST /v1/identity/mfa/totp/enrollment/confirm
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "factorId": "umf_sandbox_00000000000000000001",
  "code": "287082"
}
```

### Response

```json
{
  "factorId": "umf_sandbox_00000000000000000001",
  "status": "active",
  "confirmedAt": "2026-01-01T00:00:00.000Z",
  "recoveryCodes": [
    "00000000-00000000-00000000-00000001",
    "00000000-00000000-00000000-00000002",
    "00000000-00000000-00000000-00000003",
    "00000000-00000000-00000000-00000004",
    "00000000-00000000-00000000-00000005",
    "00000000-00000000-00000000-00000006",
    "00000000-00000000-00000000-00000007",
    "00000000-00000000-00000000-00000008",
    "00000000-00000000-00000000-00000009",
    "00000000-00000000-00000000-00000010"
  ]
}
```

## user.session.list / default

Operation ID: user_session_list
Route: GET /v1/identity/sessions
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001"
}
```

### Response

```json
{
  "sessions": [
    {
      "sessionId": "sess_sandbox_00000000000000000001",
      "userId": "usr_sandbox_00000000000000000001",
      "current": true,
      "mfaVerified": false,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "lastActivityAt": "2026-01-01T00:05:00.000Z",
      "expiresAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}
```

## user.session.revoke / default

Operation ID: user_session_revoke
Route: POST /v1/identity/sessions/{sessionId}/revoke
Callability: not SDK-callable (`sdk=false`; principal `user_session`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "sessionId": "sess_sandbox_00000000000000000002"
}
```

### Response

```json
{
  "sessionId": "sess_sandbox_00000000000000000002",
  "status": "revoked",
  "revokedAt": "2026-01-02T00:00:00.000Z"
}
```

## Public operations

Every operation below is a public route (`public` principal): it takes no credential at all. Sign-up, sign-in, and health checks live here; the requests are plain JSON anyone can send.

## personal_access_token.login_grant.exchange / default

Operation ID: personal_access_token_login_grant_exchange
Route: POST /v1/personal-access-token-login-grants/exchange
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "grant": "hyperscale_cli_grant_00000000000000000000000000000000"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "teamId": "team_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000001",
  "personalAccessTokenId": "pat_sandbox_00000000000000000001",
  "name": "Hyperscale CLI",
  "scopes": [
    "activity:read",
    "activity:write",
    "billing:read",
    "billing:write",
    "blueprints:read",
    "blueprints:write",
    "catalog:read",
    "catalog:write",
    "keys:read",
    "keys:write",
    "products:read",
    "products:write"
  ],
  "expiresAt": "2030-04-01T00:00:00.000Z",
  "status": "active",
  "secret": "hyperscale_pat_00000000000000000000000000000000"
}
```

## system.health / healthy release

Operation ID: system_health
Route: GET /v1/health
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{}
```

### Response

```json
{
  "status": "ok",
  "checkedAt": "2026-08-16T12:00:00.000Z",
  "releaseCommit": "325e7c9a1b64f69fd1e9e936090477ccf14e0ef3"
}
```

## user.email.verification.confirm / default

Operation ID: user_email_verification_confirm
Route: POST /v1/identity/email-verification/confirm
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "verificationToken": "hyperscale_verify_00000000000000000000000000000000"
}
```

### Response

```json
{
  "status": "verified",
  "email": "founder@example.com",
  "verifiedAt": "2026-01-01T00:00:00.000Z"
}
```

## user.login / default

Operation ID: user_login
Route: POST /v1/identity/login
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "founder@example.com",
  "password": "correct-horse-battery"
}
```

### Response

```json
{
  "status": "authenticated",
  "userId": "usr_sandbox_00000000000000000001",
  "mobile": "+966555123456",
  "teamId": "team_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "entityId": "ent_sandbox_00000000000000000001",
  "environment": "sandbox",
  "emailVerified": true,
  "platformOperator": false,
  "role": "owner",
  "permissions": [
    "desk.activity",
    "desk.billing",
    "desk.team",
    "desk.team.manage"
  ],
  "sessionId": "sess_sandbox_00000000000000000002",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000002",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "mfaEnrollmentRequired": false
}
```

## user.login / mfa-required

Operation ID: user_login
Route: POST /v1/identity/login
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "founder@example.com",
  "password": "correct-horse-battery"
}
```

### Response

```json
{
  "status": "mfa_required",
  "mfaChallengeToken": "hyperscale_mfa_00000000000000000000000000000001",
  "challengeExpiresAt": "2026-01-01T00:00:00.000Z"
}
```

## user.login.mfa.verify / default

Operation ID: user_login_mfa_verify
Route: POST /v1/identity/login/mfa/verify
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "mfaChallengeToken": "hyperscale_mfa_00000000000000000000000000000001",
  "code": "287082"
}
```

### Response

```json
{
  "status": "authenticated",
  "userId": "usr_sandbox_00000000000000000001",
  "mobile": "+966555123456",
  "teamId": "team_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000001",
  "entityId": "ent_sandbox_00000000000000000001",
  "environment": "sandbox",
  "emailVerified": true,
  "platformOperator": false,
  "role": "owner",
  "permissions": [
    "desk.activity",
    "desk.billing",
    "desk.team",
    "desk.team.manage"
  ],
  "sessionId": "sess_sandbox_00000000000000000004",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000004",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "recoveryCodeUsed": false,
  "sessionsRevoked": 0
}
```

## user.login.mfa.verify / denied

Operation ID: user_login_mfa_verify
Route: POST /v1/identity/login/mfa/verify
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "mfaChallengeToken": "hyperscale_mfa_00000000000000000000000000000001",
  "code": "000000"
}
```

### Response

```json
{
  "status": "denied",
  "attemptsRemaining": 4
}
```

## user.login.passkey.begin / default

Operation ID: admin_user_login_passkey_begin
Route: POST /v1/identity/login/passkey/begin
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{}
```

### Response

```json
{
  "challengeId": "pkch_sandbox_000000000000000000000001",
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000001",
  "requestOptions": {
    "challenge": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "rpId": "hyperscale0.ai",
    "timeout": 300000,
    "userVerification": "required"
  },
  "challengeExpiresAt": "2026-01-01T00:00:00.000Z"
}
```

## user.login.passkey.enrollment.begin / default

Operation ID: admin_user_login_passkey_enrollment_begin
Route: POST /v1/identity/login/passkey/enrollment/begin
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "operator@hyperscale0.ai",
  "authorizationToken": "hyperscale_passkey_auth_00000000000000000000000000000001"
}
```

### Response

```json
{
  "status": "pending",
  "challengeId": "pkch_sandbox_000000000000000000000002",
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000002",
  "creationOptions": {
    "challenge": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "rp": {
      "id": "hyperscale0.ai",
      "name": "Hyperscale"
    },
    "user": {
      "id": "dXNyX3NhbmRib3hfMDAwMDAwMDAwMDAwMDAwMDAwMDE",
      "name": "operator@hyperscale0.ai",
      "displayName": "Platform Operator"
    },
    "pubKeyCredParams": [
      {
        "alg": -7,
        "type": "public-key"
      },
      {
        "alg": -257,
        "type": "public-key"
      }
    ],
    "timeout": 300000,
    "authenticatorSelection": {
      "requireResidentKey": true,
      "residentKey": "required",
      "userVerification": "required"
    },
    "attestation": "none"
  },
  "challengeExpiresAt": "2026-01-01T00:00:00.000Z"
}
```

## user.login.passkey.enrollment.confirm / default

Operation ID: admin_user_login_passkey_enrollment_confirm
Route: POST /v1/identity/login/passkey/enrollment/confirm
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000002",
  "registrationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "attestationObject": "ZXhhbXBsZS1hdHRlc3RhdGlvbi1vYmplY3Q",
      "transports": [
        "internal",
        "hybrid"
      ]
    },
    "authenticatorAttachment": "platform",
    "clientExtensionResults": {
      "credProps": {
        "rk": true
      }
    },
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "authenticated",
  "userId": "usr_sandbox_00000000000000000001",
  "mobile": "+966555123456",
  "teamId": "team_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000002",
  "entityId": null,
  "environment": "sandbox",
  "emailVerified": true,
  "platformOperator": true,
  "role": "owner",
  "permissions": [
    "ops.activity",
    "ops.security",
    "ops.team"
  ],
  "sessionId": "sess_sandbox_00000000000000000006",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000006",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "authorizationPurpose": "bootstrap",
  "credentialsRevoked": 0,
  "sessionsRevoked": 0
}
```

## user.login.passkey.enrollment.confirm / denied

Operation ID: admin_user_login_passkey_enrollment_confirm
Route: POST /v1/identity/login/passkey/enrollment/confirm
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000002",
  "registrationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "attestationObject": "ZXhhbXBsZS1hdHRlc3RhdGlvbi1vYmplY3Q",
      "transports": [
        "internal",
        "hybrid"
      ]
    },
    "authenticatorAttachment": "platform",
    "clientExtensionResults": {
      "credProps": {
        "rk": true
      }
    },
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "denied"
}
```

## user.login.passkey.verify / default

Operation ID: admin_user_login_passkey_verify
Route: POST /v1/identity/login/passkey/verify
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000001",
  "authenticationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "authenticatorData": "ZXhhbXBsZS1hdXRoZW50aWNhdG9yLWRhdGE",
      "signature": "ZXhhbXBsZS1zaWduYXR1cmU",
      "userHandle": "dXNyX3NhbmRib3hfMDAwMDAwMDAwMDAwMDAwMDAwMDE"
    },
    "clientExtensionResults": {},
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "authenticated",
  "userId": "usr_sandbox_00000000000000000001",
  "mobile": "+966555123456",
  "teamId": "team_sandbox_00000000000000000001",
  "tenantId": "ten_sandbox_00000000000000000002",
  "entityId": null,
  "environment": "sandbox",
  "emailVerified": true,
  "platformOperator": true,
  "role": "owner",
  "permissions": [
    "ops.activity",
    "ops.security",
    "ops.team"
  ],
  "sessionId": "sess_sandbox_00000000000000000005",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000005",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z"
}
```

## user.login.passkey.verify / denied

Operation ID: admin_user_login_passkey_verify
Route: POST /v1/identity/login/passkey/verify
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "ceremonyToken": "hyperscale_passkey_00000000000000000000000000000001",
  "authenticationResponse": {
    "id": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "rawId": "b3BlcmF0b3ItY3JlZGVudGlhbA",
    "response": {
      "clientDataJSON": "ZXhhbXBsZS1jbGllbnQtZGF0YQ",
      "authenticatorData": "ZXhhbXBsZS1hdXRoZW50aWNhdG9yLWRhdGE",
      "signature": "ZXhhbXBsZS1zaWduYXR1cmU",
      "userHandle": "dXNyX3NhbmRib3hfMDAwMDAwMDAwMDAwMDAwMDAwMDE"
    },
    "clientExtensionResults": {},
    "type": "public-key"
  }
}
```

### Response

```json
{
  "status": "denied"
}
```

## user.password.reset.confirm / default

Operation ID: user_password_reset_confirm
Route: POST /v1/identity/password-reset/confirm
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "resetToken": "hyperscale_pwdreset_00000000000000000000000000000000",
  "password": "correct-horse-battery"
}
```

### Response

```json
{
  "status": "password_reset",
  "sessionsRevoked": 1
}
```

## user.password.reset.confirm / denied

Operation ID: user_password_reset_confirm
Route: POST /v1/identity/password-reset/confirm
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "resetToken": "hyperscale_pwdreset_00000000000000000000000000000001",
  "password": "correct-horse-battery"
}
```

### Response

```json
{
  "status": "denied",
  "sessionsRevoked": 0
}
```

## user.password.reset.request / default

Operation ID: user_password_reset_request
Route: POST /v1/identity/password-reset/request
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "founder@example.com"
}
```

### Response

```json
{
  "status": "accepted"
}
```

## user.signup / default

Operation ID: user_signup
Route: POST /v1/identity/signup
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "founder@example.com",
  "password": "correct-horse-battery",
  "displayName": "Founder Example",
  "mobile": "+966555123456",
  "teamName": "Example Escrow",
  "country": "SA",
  "defaultCurrency": "SAR",
  "termsAccepted": true
}
```

### Response

```json
{
  "userId": "usr_sandbox_00000000000000000001",
  "email": "founder@example.com",
  "displayName": "Founder Example",
  "mobile": "+966555123456",
  "teamId": "team_sandbox_00000000000000000001",
  "teamName": "Example Escrow",
  "tenantId": "ten_sandbox_00000000000000000001",
  "entityId": "ent_sandbox_00000000000000000001",
  "environment": "sandbox",
  "emailVerified": false,
  "mfaEnrollmentRequired": false,
  "platformOperator": false,
  "membershipId": "tmem_sandbox_00000000000000000001",
  "role": "owner",
  "permissions": [
    "desk.activity",
    "desk.team",
    "desk.team.manage"
  ],
  "teamProvisioning": "created",
  "sessionId": "sess_sandbox_00000000000000000001",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000001",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "accounts": [
    {
      "accountId": "acct_sandbox_00000000000000000001",
      "role": "tenant_billing",
      "currency": "SAR"
    },
    {
      "accountId": "acct_sandbox_00000000000000000002",
      "role": "tenant_credit",
      "currency": "SAR"
    },
    {
      "accountId": "acct_sandbox_00000000000000000003",
      "role": "tenant_settlement",
      "currency": "SAR"
    }
  ],
  "status": "active"
}
```

## user.signup / invited

Operation ID: user_signup
Route: POST /v1/identity/signup
Callability: not SDK-callable (`sdk=false`; principal `public`)

### Request

```json
{
  "email": "developer@example.com",
  "password": "correct-horse-battery",
  "displayName": "Developer Example",
  "mobile": "+966555123457",
  "teamName": "Example Escrow",
  "inviteToken": "hyperscale_invite_0123456789abcdefghijklmnopqrstuv",
  "termsAccepted": true
}
```

### Response

```json
{
  "userId": "usr_sandbox_00000000000000000002",
  "email": "developer@example.com",
  "displayName": "Developer Example",
  "mobile": "+966555123457",
  "teamId": "team_sandbox_00000000000000000001",
  "teamName": "Example Escrow",
  "tenantId": "ten_sandbox_00000000000000000001",
  "entityId": "ent_sandbox_00000000000000000001",
  "environment": "sandbox",
  "emailVerified": true,
  "mfaEnrollmentRequired": false,
  "platformOperator": false,
  "membershipId": "tmem_sandbox_00000000000000000002",
  "role": "developer",
  "permissions": [
    "desk.activity",
    "desk.products"
  ],
  "teamProvisioning": "joined",
  "sessionId": "sess_sandbox_00000000000000000003",
  "sessionToken": "hyperscale_sess_00000000000000000000000000000003",
  "sessionExpiresAt": "2026-01-01T00:00:00.000Z",
  "accounts": [
    {
      "accountId": "acct_sandbox_00000000000000000001",
      "role": "tenant_billing",
      "currency": "SAR"
    },
    {
      "accountId": "acct_sandbox_00000000000000000002",
      "role": "tenant_credit",
      "currency": "SAR"
    },
    {
      "accountId": "acct_sandbox_00000000000000000003",
      "role": "tenant_settlement",
      "currency": "SAR"
    }
  ],
  "status": "active"
}
```

## System operations

Every operation below runs under the platform's own `system` principal. No customer credential, API key or portal session, can call these routes; the raw JSON requests document what the platform executes internally.

## admin.billing.platform_rate.clear / clear_pro_collection_rate

Operation ID: admin_billing_platform_rate_clear
Route: POST /v1/admin/platform-rates/{platformRateOverrideId}/clear
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "platformRateOverrideId": "prx_sandbox_example0001",
  "reason": "Back to the authored price list"
}
```

### Response

```json
{
  "platformRateOverrideId": "prx_sandbox_example0001",
  "rateId": "collection_count",
  "amountSar": "2.50",
  "bps": null,
  "reason": "Platform pricing review: collections",
  "status": "revoked",
  "createdOperationId": "ops_sandbox_example0001",
  "revokedOperationId": "ops_sandbox_example0002"
}
```

## admin.billing.platform_rate.set / collection_rate

Operation ID: admin_billing_platform_rate_set
Route: POST /v1/admin/platform-rates
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "rateId": "collection_count",
  "amountSar": "2.50",
  "reason": "Platform pricing review: collections"
}
```

### Response

```json
{
  "platformRateOverrideId": "prx_sandbox_example0001",
  "rateId": "collection_count",
  "amountSar": "2.50",
  "bps": null,
  "reason": "Platform pricing review: collections",
  "status": "active",
  "createdOperationId": "ops_sandbox_example0001",
  "revokedOperationId": null
}
```

## admin.product.retrieve / Operator Product summary

Operation ID: admin_product_retrieve
Route: GET /v1/admin/products/{productId}
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "productId": "prd_sandbox_escrowmarket01"
}
```

### Response

```json
{
  "productId": "prd_sandbox_escrowmarket01",
  "tenantId": "ten_sandbox_founderco01",
  "environment": "sandbox",
  "displayName": "Vehicle Escrow Marketplace",
  "slug": "vehicle-escrow-marketplace",
  "kind": "offering",
  "status": "active",
  "blueprint": {
    "id": "vehicle-escrow-marketplace",
    "name": "Vehicle Escrow Marketplace"
  },
  "instrumentIds": [
    "vehicle_listing",
    "vehicle_escrow"
  ],
  "pricing": {
    "current": {
      "monthlySar": "1000",
      "setupSar": "5000",
      "complexityScore": 0,
      "rates": [],
      "pricingIdentity": "da822dda8add5575b1749bf930b91747f479cfe9bbd4409d45f43aa56fe9e294",
      "priceBasisIdentity": "da822dda8add5575b1749bf930b91747f479cfe9bbd4409d45f43aa56fe9e294"
    },
    "scheduled": null
  },
  "billingBoundaryAt": "2026-10-01T00:00:00.000Z",
  "readiness": {
    "live": false,
    "outstandingLiveRequirements": [
      "bank_letter",
      "live_ledger_partition"
    ],
    "liveUnavailableCapabilities": []
  },
  "capabilities": [
    {
      "capabilityId": "accounts",
      "name": "Accounts"
    }
  ],
  "cost": {
    "currency": "SAR",
    "platformMonthlySar": "1000",
    "platformSetupSar": "5000",
    "liveCapableCount": 0,
    "recurringCharges": [],
    "usageCharges": [],
    "estimatedMonthlyFixedSar": "1000",
    "blockers": [],
    "complete": true
  },
  "surfaces": {
    "graphql": {
      "artifactType": "graphql_schema",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/graphql"
    },
    "mcp": {
      "artifactType": "mcp",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/mcp?capabilityIds=accounts"
    },
    "openapi": {
      "artifactType": "openapi_spec",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/products/prd_sandbox_escrowmarket01/openapi.json"
    },
    "sdk": {
      "artifactType": "sdk_kit",
      "environment": "sandbox",
      "activationRequired": false,
      "requiredAction": "none",
      "url": "/v1/products/prd_sandbox_escrowmarket01/kit"
    }
  }
}
```

## attribution_queue.list / first_page

Operation ID: admin_attribution_queue_list
Route: GET /v1/internal/attribution-queue
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## beneficiary.activate / activate_beneficiary

Operation ID: admin_beneficiary_activate
Route: POST /v1/beneficiaries/{beneficiaryId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "beneficiaryId": "ben_sandbox_seller000001"
}
```

## billing.platform.revenue.account.provision / sandbox_platform_revenue

Operation ID: admin_billing_platform_revenue_account_provision
Route: POST /v1/billing/platform-revenue-account
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "currency": "SAR"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "accountId": "acct_sandbox_platformrevenue01",
  "role": "platform_revenue",
  "currency": "SAR",
  "normalBalance": "credit",
  "status": "open",
  "ledgerBindingStatus": "created"
}
```

## bureau_report.generate / weekly-facility-batch

Operation ID: admin_bureau_report_generate
Route: POST /v1/reporting/bureau-batches
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "memberReference": "member_hyperscale_finance",
  "period": {
    "start": "2026-06-22",
    "end": "2026-06-28"
  },
  "records": [
    {
      "customer": {
        "fullName": "Abdullah Saad Al Qahtani",
        "nationalId": "1045678901",
        "dateOfBirth": "1992-03-14",
        "nationality": "SA",
        "address": "2453 King Fahd Road, Riyadh 12271"
      },
      "facility": {
        "facilityReference": "agr_murabaha_0001",
        "facilityType": "murabaha_installment",
        "openedAt": "2026-01-05",
        "originalMinor": "1500000",
        "outstandingMinor": "1250000",
        "installmentMinor": "262500",
        "paymentType": "installment"
      },
      "status": {
        "paymentsMade": 6,
        "totalOverdueMinor": "0",
        "paymentStatus": "current",
        "disputed": false
      }
    }
  ],
  "producedAt": "2026-07-01T00:05:00.000Z"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "reportingArtifactId": "rpt_sandbox_bureau000001",
  "artifact": {
    "kind": "bureau_facility_batch",
    "reference": "bureau_facility_batch:member_hyperscale_finance:2026-06-28",
    "subjectReference": "member_hyperscale_finance",
    "period": {
      "start": "2026-06-22",
      "end": "2026-06-28"
    },
    "version": 1,
    "producedAt": "2026-07-01T00:05:00.000Z",
    "digest": "46497f2802197facd5328ffb4d43870f7b714a4b4ba41bf81d6890a0823609b4",
    "body": {
      "recordCount": 1,
      "totalOutstandingMinor": "1250000",
      "totalOverdueMinor": "0",
      "records": [
        {
          "customer": {
            "fullName": "Abdullah Saad Al Qahtani",
            "nationalId": "1045678901",
            "dateOfBirth": "1992-03-14",
            "nationality": "SA",
            "address": "2453 King Fahd Road, Riyadh 12271"
          },
          "facility": {
            "facilityReference": "agr_murabaha_0001",
            "facilityType": "murabaha_installment",
            "openedAt": "2026-01-05",
            "originalMinor": "1500000",
            "outstandingMinor": "1250000",
            "installmentMinor": "262500",
            "paymentType": "installment"
          },
          "status": {
            "paymentsMade": 6,
            "totalOverdueMinor": "0",
            "paymentStatus": "current",
            "disputed": false
          }
        }
      ]
    }
  }
}
```

## card_authorization.expire / expire_uncaptured_authorization

Operation ID: admin_card_authorization_expire
Route: POST /v1/card-authorizations/{cardAuthorizationId}/expire
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "cardAuthorizationId": "cau_sandbox_purchase00001",
  "tenantId": "ten_sandbox_cards000001"
}
```

## card_dispute.lose / close_unresolved_dispute_at_deadline

Operation ID: admin_card_dispute_lose
Route: POST /v1/card-disputes/{cardDisputeId}/lose
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "cardDisputeId": "cdis_sandbox_purchase0001",
  "tenantId": "ten_sandbox_cards000001"
}
```

## circle_membership.activate / activate_seat

Operation ID: admin_circle_membership_activate
Route: POST /v1/circle-memberships/{circleMembershipId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "circleMembershipId": "jmm_sandbox_seat000001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## circle_membership.contribute / contribute_monthly

Operation ID: admin_circle_membership_contribute
Route: POST /v1/circle-memberships/{circleMembershipId}/contribute
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "circleMembershipId": "jmm_sandbox_seat000001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## circle_membership.receive_pot / receive_pot_in_turn

Operation ID: admin_circle_membership_receive_pot
Route: POST /v1/circle-memberships/{circleMembershipId}/receive-pot
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "circleMembershipId": "jmm_sandbox_seat000001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## circle_membership.withdraw / withdraw_disbanded_seat

Operation ID: admin_circle_membership_withdraw
Route: POST /v1/circle-memberships/{circleMembershipId}/withdraw
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "circleMembershipId": "jmm_sandbox_seat000001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## default_rate_publication.generate / quarterly-publication

Operation ID: admin_default_rate_publication_generate
Route: POST /v1/reporting/default-rate-publications
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "publisherReference": "hyperscale_consumer_finance",
  "period": {
    "start": "2026-04-01",
    "end": "2026-06-30"
  },
  "agreements": [
    {
      "agreementReference": "agr_murabaha_0001",
      "productReference": "prd_bnpl_tawarruq",
      "originatedAt": "2026-01-05",
      "status": "current",
      "principalMinor": "1500000"
    },
    {
      "agreementReference": "agr_murabaha_0002",
      "productReference": "prd_bnpl_tawarruq",
      "originatedAt": "2026-02-18",
      "status": "delinquent",
      "principalMinor": "300000"
    },
    {
      "agreementReference": "agr_murabaha_0003",
      "productReference": "prd_bnpl_tawarruq",
      "originatedAt": "2026-03-09",
      "status": "paid_off",
      "principalMinor": "600000"
    }
  ],
  "producedAt": "2026-07-01T00:05:00.000Z"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "reportingArtifactId": "rpt_sandbox_defrate00001",
  "artifact": {
    "kind": "default_rate_publication",
    "reference": "default_rate_publication:hyperscale_consumer_finance:2026-06-30",
    "subjectReference": "hyperscale_consumer_finance",
    "period": {
      "start": "2026-04-01",
      "end": "2026-06-30"
    },
    "version": 1,
    "producedAt": "2026-07-01T00:05:00.000Z",
    "digest": "74c19a47b037e6b8a009f8ea7db6d0ec3495ca83bab683d0b59a0a1caeb8cb8e",
    "body": {
      "cohorts": [
        {
          "productReference": "prd_bnpl_tawarruq",
          "cohort": "2026-Q1",
          "agreementCount": 3,
          "statusCounts": {
            "current": 1,
            "delinquent": 1,
            "chargedOff": 0,
            "paidOff": 1
          },
          "principalOriginatedMinor": "2400000",
          "principalChargedOffMinor": "0",
          "defaultRateBps": 0
        }
      ]
    }
  }
}
```

## deposit.record / record_attributed_deposit

Operation ID: admin_deposit_record
Route: POST /v1/deposits
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "sourceAccountId": "acct_sandbox_master00001",
  "destinationAccountId": "acct_sandbox_customer0001",
  "financialAddressId": "faddr_sandbox_customer0001",
  "amount": "25000",
  "currency": "SAR",
  "provider": "sarie_sponsor_bank",
  "providerReference": "credit-example-0001",
  "receivedAt": "2026-07-09T12:00:00.000Z"
}
```

## deposit.return / return_deposit

Operation ID: admin_deposit_return
Route: POST /v1/deposits/{depositId}/return
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "depositId": "dep_sandbox_customer0001",
  "transferId": "trn_sandbox_deposit000001",
  "provider": "sarie_sponsor_bank",
  "providerReference": "return-example-0001",
  "returnReason": "The payer recalled the payment.",
  "returnedAt": "2026-07-10T12:00:00.000Z"
}
```

## escrow_order.expire / expire_unfunded_escrow

Operation ID: admin_escrow_order_expire
Route: POST /v1/escrow-orders/{escrowOrderId}/expire
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "escrowOrderId": "eord_sandbox_buyerorder01",
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## financial_address.activate / activate_financial_address

Operation ID: admin_financial_address_activate
Route: POST /v1/financial-addresses/{financialAddressId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "financialAddressId": "faddr_sandbox_customer0001",
  "provider": "sarie_sponsor_bank",
  "providerReference": "address-example-0001",
  "address": "SA8080000000608010167519",
  "activeAt": "2026-07-09T12:00:00.000Z"
}
```

## funding_commitment.collect / collect_activated_pledge

Operation ID: admin_funding_commitment_collect
Route: POST /v1/funding-commitments/{fundingCommitmentId}/collect
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "fundingCommitmentId": "fnc_sandbox_pledge00001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## funding_commitment.refund / refund_failed_round_pledge

Operation ID: admin_funding_commitment_refund
Route: POST /v1/funding-commitments/{fundingCommitmentId}/refund
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "fundingCommitmentId": "fnc_sandbox_pledge00001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## funding_round.activate / activate_funded_round

Operation ID: admin_funding_round_activate
Route: POST /v1/funding-rounds/{fundingRoundId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "fundingRoundId": "fnr_sandbox_equipround1",
  "tenantId": "ten_sandbox_masarat01"
}
```

## funding_round.fail / fail_short_round

Operation ID: admin_funding_round_fail
Route: POST /v1/funding-rounds/{fundingRoundId}/fail
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "fundingRoundId": "fnr_sandbox_equipround1",
  "tenantId": "ten_sandbox_masarat01"
}
```

## installment.collect / collect_overdue_installment

Operation ID: admin_installment_collect
Route: POST /v1/installments/{installmentId}/collect
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "installmentId": "inst_sandbox_repayment001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## installment.mark_overdue / mark_installment_overdue

Operation ID: admin_installment_mark_overdue
Route: POST /v1/installments/{installmentId}/mark-overdue
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "installmentId": "inst_sandbox_repayment001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## lender_distribution.payout / pay_lender_distribution

Operation ID: admin_lender_distribution_payout
Route: POST /v1/lender-distributions/{lenderDistributionId}/payout
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "lenderDistributionId": "lnd_sandbox_claim000001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## listing.expire / expire_stale_offer

Operation ID: admin_listing_expire
Route: POST /v1/listings/{listingId}/expire
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "listingId": "lst_sandbox_landcruiser1",
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## order.expire / expire_unconfirmed_purchase

Operation ID: admin_order_expire
Route: POST /v1/orders/{orderId}/expire
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "orderId": "ord_sandbox_landcruiser01",
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## payout.complete / complete_payout

Operation ID: admin_payout_complete
Route: POST /v1/payouts/{payoutId}/complete
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "transferId": "trn_sandbox_payout000001",
  "provider": "sarie_sponsor_bank",
  "providerReference": "payout-example-0001",
  "completedAt": "2026-07-09T12:01:00.000Z"
}
```

## payout.fail / fail_payout

Operation ID: admin_payout_fail
Route: POST /v1/payouts/{payoutId}/fail
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "transferId": "trn_sandbox_payout000001",
  "provider": "sarie_sponsor_bank",
  "providerReference": "payout-example-0001",
  "failureReason": "The beneficiary account is closed.",
  "failedAt": "2026-07-09T12:01:00.000Z"
}
```

## payout.reject / reject_payout_reservation

Operation ID: admin_payout_reject
Route: POST /v1/payouts/{payoutId}/reject
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "transferId": "trn_sandbox_payout000001",
  "failureCode": "insufficient_balance",
  "failureReason": "The source account has insufficient available funds.",
  "failedAt": "2026-07-09T12:00:00.000Z"
}
```

## payout.reserve / reserve_payout

Operation ID: admin_payout_reserve
Route: POST /v1/payouts/{payoutId}/reserve
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "sourceAccountId": "acct_sandbox_seller0001",
  "amount": "25000",
  "currency": "SAR"
}
```

## payout.return / return_payout

Operation ID: admin_payout_return
Route: POST /v1/payouts/{payoutId}/return
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "transferId": "trn_sandbox_payout000001",
  "provider": "sarie_sponsor_bank",
  "providerReference": "payout-return-0001",
  "returnReason": "The beneficiary rejected the credit.",
  "returnedAt": "2026-07-10T12:00:00.000Z"
}
```

## payout.submit / submit_payout

Operation ID: admin_payout_submit
Route: POST /v1/payouts/{payoutId}/submit
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "payoutId": "pay_sandbox_seller000001",
  "transferId": "trn_sandbox_payout000001",
  "sourceAccountId": "acct_sandbox_seller0001",
  "amount": "25000",
  "currency": "SAR"
}
```

## payout_run.execute / execute_creator_payout

Operation ID: admin_payout_run_execute
Route: POST /v1/payout-runs/{payoutRunId}/execute
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "payoutRunId": "prun_sandbox_creator0001",
  "tenantId": "ten_sandbox_creator0001"
}
```

## platform.operator.passkey.enrollment.authorize / bootstrap

Operation ID: platform_operator_passkey_enrollment_authorize
Route: POST /v1/platform/operators/passkey-enrollment/authorize
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "email": "operator@hyperscale0.ai",
  "purpose": "bootstrap",
  "reason": "Initial platform operator enrollment"
}
```

### Response

```json
{
  "authorizationId": "pkauth_sandbox_000000000000000000000001",
  "authorizationToken": "hyperscale_passkey_auth_00000000000000000000000000000001",
  "authorizationExpiresAt": "2026-01-01T00:10:00.000Z",
  "purpose": "bootstrap",
  "userId": "usr_sandbox_00000000000000000001"
}
```

## policy.activate / activate_cover_at_start

Operation ID: admin_policy_activate
Route: POST /v1/policies/{policyId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "policyId": "pol_sandbox_protection001",
  "tenantId": "ten_sandbox_protection01"
}
```

## policy.expire / expire_cover_at_term

Operation ID: admin_policy_expire
Route: POST /v1/policies/{policyId}/expire
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "policyId": "pol_sandbox_protection001",
  "tenantId": "ten_sandbox_protection01"
}
```

## product.program.relower / default

Operation ID: admin_product_program_relower
Route: POST /v1/internal/product-program-relowerings
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "program": {
    "source": "program car_escrow \"Car escrow\"\n\nimport { held_payment } from \"std/money_flows\"\n\nparty buyer: person\nparty seller: business\n\nasset vehicle: good { title_transfer: off_platform }\n\nsettlement order = held_payment {\n  payer: buyer\n  payee: seller\n  amount: price: money(SAR)\n  release: port confirm_handover\n  fees { buyer: 1%, seller: 2% }\n  on_cancel(funded) { buyer: 99.5%, seller: 0.5% }\n}\n\nport confirm_handover {\n  allowed: [buyer]\n  shape: { vehicleId: id(vehicle) }\n}\n"
  },
  "reason": "The 2026-08 grammar release dropped the action this program was authored against; re-authored under the current grammar."
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_00000000000000000001",
  "productId": "prd_sandbox_00000000000000000001",
  "productBuildId": "pbld_sandbox_00000000000000000002",
  "reloweredFromBuildId": "pbld_sandbox_00000000000000000001",
  "instrumentIds": [
    "order"
  ],
  "buildDigest": "13735ad0de7a4e93b003fb0ba1c371e77652474b0793f0047774905677159a3b",
  "manifestSchemaVersion": "0.9.0",
  "reason": "The 2026-08 grammar release dropped the action this program was authored against; re-authored under the current grammar.",
  "unreadableProgramIssues": [
    {
      "code": "action_unknown_key",
      "message": "unknown action key `settle`",
      "path": "instruments.order.actions.settle"
    }
  ]
}
```

## reconciliation_break_repair.execute / close_a_bank_fee_break

Operation ID: admin_reconciliation_break_repair_execute
Route: POST /v1/internal/reconciliation-break-repairs
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "reconciliationRunId": "rrun_sandbox_window0000001",
  "statementLineId": "sln_sandbox_bankfee00000001",
  "cause": "bank_fee",
  "accountId": "acct_sandbox_operating000001",
  "amount": "115",
  "currency": "SAR",
  "reason": "Monthly account maintenance charge levied by the bank."
}
```

### Response

```json
{
  "reconciliationBreakRepairId": "brep_sandbox_bankfee00000001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "reconciliationBreakId": "rbrk_sandbox_bankfee00000001",
  "reconciliationRunId": "rrun_sandbox_window0000001",
  "statementLineId": "sln_sandbox_bankfee00000001",
  "cause": "bank_fee",
  "accountId": "acct_sandbox_operating000001",
  "transferId": "trn_sandbox_breakrepair0001",
  "amount": "115",
  "currency": "SAR",
  "bankOccurredAt": "2026-07-09T11:04:00.000Z",
  "reason": "Monthly account maintenance charge levied by the bank.",
  "evidence": {
    "providerReference": "MT940-2026-07-09-0007",
    "source": "alfaris-mt940",
    "reasonCodes": [
      "bank_movement_mismatch"
    ],
    "bankDifference": "-115"
  }
}
```

## reconciliation_run.execute / reconcile_day

Operation ID: admin_reconciliation_run_execute
Route: POST /v1/internal/reconciliation-runs
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "windowStart": "2026-07-09T00:00:00.000Z",
  "windowEnd": "2026-07-10T00:00:00.000Z"
}
```

## safeguarding_report.generate / funded-reconciliation

Operation ID: admin_safeguarding_report_generate
Route: POST /v1/reporting/safeguarding-reconciliations
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "scopeReference": "safeguarding_sar_client_money",
  "asOf": "2026-06-30",
  "balances": [
    {
      "accountReference": "acct_customer_balances_sar",
      "role": "customer_balance",
      "currency": "SAR",
      "balanceMinor": "8250000"
    },
    {
      "accountReference": "acct_master_mirror_sar",
      "role": "tenant_master_mirror",
      "currency": "SAR",
      "balanceMinor": "8250000"
    }
  ],
  "producedAt": "2026-07-01T00:05:00.000Z"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "reportingArtifactId": "rpt_sandbox_safeguard001",
  "artifact": {
    "kind": "safeguarding_reconciliation",
    "reference": "safeguarding_reconciliation:safeguarding_sar_client_money:2026-06-30",
    "subjectReference": "safeguarding_sar_client_money",
    "period": {
      "start": "2026-06-30",
      "end": "2026-06-30"
    },
    "version": 1,
    "producedAt": "2026-07-01T00:05:00.000Z",
    "digest": "c8376549db1453cff2584dd4f6848dd71647a6231ef3f90dd3981cd803bfc9b3",
    "body": {
      "asOf": "2026-06-30",
      "lines": [
        {
          "currency": "SAR",
          "clientLiabilitiesMinor": "8250000",
          "safeguardedMinor": "8250000",
          "surplusMinor": "0",
          "shortfallMinor": "0",
          "verdict": "funded"
        }
      ],
      "verdict": "funded"
    }
  },
  "findings": []
}
```

## savings_circle.activate / activate_full_circle

Operation ID: admin_savings_circle_activate
Route: POST /v1/savings-circles/{savingsCircleId}/activate
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "savingsCircleId": "jam_sandbox_alharbi0001",
  "tenantId": "ten_sandbox_masarat01"
}
```

## statement.generate / monthly-statement

Operation ID: admin_statement_generate
Route: POST /v1/reporting/statements
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "agreementReference": "agr_murabaha_0001",
  "currency": "SAR",
  "period": {
    "start": "2026-06-01",
    "end": "2026-06-30"
  },
  "scheduleVersion": {
    "agreementReference": "agr_murabaha_0001",
    "version": 1,
    "authoredBy": "provider",
    "createdAt": "2026-01-05T09:00:00.000Z",
    "rows": [
      {
        "seq": 6,
        "dueDate": "2026-06-27",
        "principal": {
          "expectedMinor": "250000",
          "paidMinor": "250000",
          "dueMinor": "0"
        },
        "profit": {
          "expectedMinor": "12500",
          "paidMinor": "12500",
          "dueMinor": "0"
        },
        "fee": {
          "expectedMinor": "0",
          "paidMinor": "0",
          "dueMinor": "0"
        },
        "state": "paid"
      }
    ]
  },
  "dailySummaries": [
    {
      "agreementReference": "agr_murabaha_0001",
      "date": "2026-06-27",
      "accruedProfitMinor": "12500",
      "paidPrincipalMinor": "250000",
      "paidProfitMinor": "12500",
      "paidFeeMinor": "0",
      "disbursedMinor": "0"
    }
  ],
  "openingPrincipalOutstandingMinor": "1500000",
  "producedAt": "2026-07-01T00:05:00.000Z"
}
```

### Response

```json
{
  "tenantId": "ten_sandbox_masarat01",
  "reportingArtifactId": "rpt_sandbox_stmt00000001",
  "artifact": {
    "kind": "customer_statement",
    "reference": "customer_statement:agr_murabaha_0001:2026-06-30",
    "subjectReference": "agr_murabaha_0001",
    "period": {
      "start": "2026-06-01",
      "end": "2026-06-30"
    },
    "version": 1,
    "producedAt": "2026-07-01T00:05:00.000Z",
    "digest": "1cfca8dd0d8ae4e772a8d6bb949a0f1fb7cb3f48b3ba6182bac0a229acc8d38e",
    "body": {
      "agreementReference": "agr_murabaha_0001",
      "currency": "SAR",
      "scheduleVersionNumber": 1,
      "activity": [
        {
          "date": "2026-06-27",
          "accruedProfitMinor": "12500",
          "paidPrincipalMinor": "250000",
          "paidProfitMinor": "12500",
          "paidFeeMinor": "0",
          "disbursedMinor": "0"
        }
      ],
      "totals": {
        "accruedProfitMinor": "12500",
        "paidPrincipalMinor": "250000",
        "paidProfitMinor": "12500",
        "paidFeeMinor": "0",
        "disbursedMinor": "0"
      },
      "principal": {
        "openingOutstandingMinor": "1500000",
        "disbursedMinor": "0",
        "paidMinor": "250000",
        "closingOutstandingMinor": "1250000"
      },
      "installments": [
        {
          "seq": 6,
          "dueDate": "2026-06-27",
          "state": "paid",
          "principalDueMinor": "0",
          "profitDueMinor": "0",
          "feeDueMinor": "0"
        }
      ]
    }
  }
}
```

## statement.ingest / ingest_normalized_credit

Operation ID: admin_statement_ingest
Route: POST /v1/internal/statements/ingest
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "lines": [
    {
      "source": "synthetic-bank",
      "providerReference": "synthetic-credit-0001",
      "digest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "direction": "credit",
      "amount": "25000",
      "currency": "SAR",
      "occurredAt": "2026-07-09T12:00:00.000Z",
      "valueDate": "2026-07-09T12:00:00.000Z",
      "destinationFinancialAddress": "SA8080000000608010167519",
      "sourceFormat": "synthetic_json"
    }
  ]
}
```

## str_case.advance / advance_to_drafted

Operation ID: admin_str_case_advance
Route: POST /v1/internal/str-cases/advance
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "subjectTenantId": "ten_sandbox_riyadhresale01",
  "alertReference": "alert_2026_08_0007",
  "to": "str_drafted",
  "actor": "compliance.analyst"
}
```

## str_case.open / open_case

Operation ID: admin_str_case_open
Route: POST /v1/internal/str-cases
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "subjectTenantId": "ten_sandbox_riyadhresale01",
  "subjectRef": "cus_sandbox_screened_party",
  "alertReference": "alert_2026_08_0007",
  "actor": "compliance.analyst"
}
```

## system.user.credential.mint / create

Operation ID: system_user_credential_mint
Route: POST /v1/system/users/credentials/mint
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "environment": "sandbox",
  "mode": "create",
  "tenant": "example-fintech",
  "email": "operator@example.sa",
  "role": "owner",
  "displayName": "Named Operator",
  "mobile": "+966500000000",
  "reason": "Owner-authorized tenant login creation"
}
```

### Response

```json
{
  "environment": "sandbox",
  "mode": "create",
  "tenantId": "ten_sandbox_00000000000000000001",
  "userId": "usr_sandbox_00000000000000000001",
  "email": "operator@example.sa",
  "role": "owner",
  "sessionsRevoked": 0,
  "reason": "Owner-authorized tenant login creation",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "password": "generated-password-value"
}
```

## system.user.credential.mint / rotate

Operation ID: system_user_credential_mint
Route: POST /v1/system/users/credentials/mint
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "environment": "live",
  "mode": "rotate",
  "tenant": "ten_live_00000000000000000001",
  "email": "operator@example.sa",
  "reason": "Owner-authorized tenant credential rotation"
}
```

### Response

```json
{
  "environment": "live",
  "mode": "rotate",
  "tenantId": "ten_live_00000000000000000001",
  "userId": "usr_live_00000000000000000001",
  "email": "operator@example.sa",
  "role": "owner",
  "sessionsRevoked": 2,
  "reason": "Owner-authorized tenant credential rotation",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "password": "generated-password-value"
}
```

## trade_settlement.post / post_two_sided_trade

Operation ID: admin_trade_settlement_post
Route: POST /v1/trade-settlements/{tradeSettlementId}/post
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_exchange0001",
  "tradeSettlementId": "trade_sandbox_exchange0001"
}
```

## trust_evidence.external_confirmation.ingest / default

Operation ID: admin_trust_evidence_external_confirmation_ingest
Route: POST /v1/trust-reviews/{trustReviewId}/external-confirmation
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "externalConfirmationId": "xcnf_sandbox_wathq0001",
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "outcome": "passed",
  "checkedAt": "2026-05-22T09:15:00.000Z",
  "metadata": {
    "check": "commercial_registry"
  }
}
```

### Response

```json
{
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "externalConfirmationId": "xcnf_sandbox_wathq0001",
  "provider": "wathq",
  "providerReference": "wathq-check-0001",
  "kind": "provider_check",
  "outcome": "passed",
  "status": "accepted",
  "trustRequirementId": "vreq_sandbox_bankletter01"
}
```

## trust_evidence.external_confirmation.record / default

Operation ID: admin_trust_evidence_external_confirmation_record
Route: POST /v1/trust-review-external-confirmation
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "provider": "wathq",
  "providerReference": "wathq-check-0001",
  "checkedAt": "2026-05-22T09:10:00.000Z",
  "metadata": {
    "check": "commercial_registry"
  }
}
```

### Response

```json
{
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "externalConfirmationId": "xcnf_sandbox_wathq0001",
  "provider": "wathq",
  "providerReference": "wathq-check-0001",
  "kind": "provider_check",
  "status": "pending",
  "trustRequirementId": "vreq_sandbox_bankletter01"
}
```

## trust_requirement.record / default

Operation ID: admin_trust_requirement_record
Route: POST /v1/trust-requirements
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "trustReviewSubjectId": "vsub_sandbox_signatory001",
  "requirementKey": "bank_letter",
  "status": "open",
  "proofSource": "tenant_evidence",
  "dueAt": "2026-05-29T09:00:00.000Z",
  "metadata": {
    "label": "Upload a bank letter for the signatory"
  }
}
```

### Response

```json
{
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "requirementKey": "bank_letter",
  "proofSource": "tenant_evidence",
  "status": "open"
}
```

## trust_requirement.waive / default

Operation ID: admin_trust_requirement_waive
Route: POST /v1/trust-requirements/{trustRequirementId}/waive
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "reason": "Provider registry confirms the requirement is not applicable.",
  "externalConfirmationId": "xcnf_sandbox_wathq0001",
  "metadata": {
    "reviewer": "compliance"
  }
}
```

### Response

```json
{
  "trustRequirementId": "vreq_sandbox_bankletter01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "status": "waived",
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "waivedAt": "2026-05-22T09:20:00.000Z",
  "externalConfirmationId": "xcnf_sandbox_wathq0001",
  "reason": "Provider registry confirms the requirement is not applicable."
}
```

## trust_review.cancel / default

Operation ID: admin_trust_review_cancel
Route: POST /v1/trust-reviews/{trustReviewId}/cancel
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "reason": "Applicant withdrew the live activation request.",
  "metadata": {
    "reviewer": "compliance"
  }
}
```

### Response

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "status": "cancelled"
}
```

## trust_review.refresh / default

Operation ID: admin_trust_review_refresh
Route: POST /v1/trust-reviews/{trustReviewId}/refresh
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_live_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "screeningKind": "aml_screening",
  "provider": "amlprovider",
  "providerReference": "screen_live_0001",
  "outcome": "passed",
  "screenedAt": "2026-05-22T09:15:00.000Z",
  "nextRefreshAt": "2026-06-21T09:15:00.000Z",
  "metadata": {
    "cadence": "continuous"
  }
}
```

### Response

```json
{
  "trustEvidenceId": "vev_sandbox_wathq0001",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_live_riyadhresale01",
  "kind": "provider_check",
  "screeningKind": "aml_screening",
  "outcome": "passed",
  "nextRefreshAt": "2026-06-21T09:15:00.000Z"
}
```

## trust_review.review / default

Operation ID: admin_trust_review_review
Route: POST /v1/trust-reviews/{trustReviewId}/review
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "reason": "Provider review started.",
  "metadata": {
    "reviewer": "compliance"
  }
}
```

### Response

```json
{
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "status": "under_review"
}
```

## trust_review_subject.upsert / default

Operation ID: admin_trust_review_subject_upsert
Route: POST /v1/trust-review-subjects
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "entityId": "ent_sandbox_riyadhresale01",
  "role": "authorized_signatory",
  "status": "pending",
  "controlType": "signing_authority",
  "isPoliticallyExposed": false
}
```

### Response

```json
{
  "trustReviewSubjectId": "vsub_sandbox_signatory001",
  "trustReviewId": "vcs_sandbox_livekyb001",
  "tenantId": "ten_sandbox_riyadhresale01",
  "entityId": "ent_sandbox_riyadhresale01",
  "role": "authorized_signatory",
  "status": "pending",
  "ownershipPercentage": null,
  "controlType": "signing_authority",
  "isPoliticallyExposed": false,
  "remainingOwnershipPercentage": 100
}
```

## unmatched_deposit.list / first_page

Operation ID: admin_unmatched_deposit_list
Route: GET /v1/internal/unmatched-deposits
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## wedged_money.scan / scan_tenant

Operation ID: admin_wedged_money_scan
Route: GET /v1/internal/wedged-money
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01"
}
```

## wedged_money_repair.execute / release_a_stuck_hold

Operation ID: admin_wedged_money_repair_execute
Route: POST /v1/internal/wedged-money-repairs
Callability: not SDK-callable (`sdk=false`; principal `system`)

### Request

```json
{
  "tenantId": "ten_sandbox_riyadhresale01",
  "wedgedOperationId": "ops_sandbox_wedgedreserve01",
  "transferId": "trn_sandbox_wedgedreserve01",
  "expectedLedgerPendingTransferId": "1024",
  "amount": "25000",
  "currency": "SAR",
  "action": "void",
  "reason": "Reserve crashed before finalization; releasing the hold."
}
```
