Sandbox

Advance the sandbox Product clock

Advances the sandbox clock of the Product bound to the key, or productId named by an authorised tenant session. A key cannot name another Product. Due actions, deadlines and allocation earning read this instant. An unused Product may set its first clock instant in the past, at most 18 calendar months before tenant creation. Business objects, instrument events and money movements prevent a past start. Once set, at only moves the clock forward. Send release instead of at to return the clock to wall time at any point, including from ahead of it; records stamped while the clock ran ahead keep their stamps. Before it responds, the advance runs every clock action that is now due, counts them in ranCount and lists the first 2000 in ran: the record and its title, the customer, the action and the same action in the program's words, its due instant, succeeded or refused, the amount it moves, and for a refusal the reason and, when it is an unfunded charge, that it retries and the account, the amount it needed and the shortfall. Each advance first retries every unfunded charge refused before it, oldest first, and the maintenance sweep retries one about once a minute. Any other refusal is lasting: it carries no retries, stays refused until an action on its record or a write to it, and shows as work for the team. A clock action whose action requires a reference in a state, such as a schedule piece before the payer activates the schedule, waits and is not listed; the activation collects it. A due on any other action only makes it runnable, and a passed deadline refuses its action. The receipt records its previous and new instants. Wall time and other Products are unchanged.

post/v1/sandbox/clock/advance

Request

  • Base URL: https://hyperscale0.ai
  • URL: https://hyperscale0.ai/v1/sandbox/clock/advance
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

X-Hyperscale-Environment'sandbox' | 'live'
Idempotency-Keystring required

Request body

productIdstring

Hyperscale product ID

atstring date-time
releasetrue

Response

Success

tenantIdstring required

Organization tenant ID

productIdstring required

Hyperscale product ID

previousAtstring date-time required
atstring date-time required
ranCountinteger

How many clock actions the advance ran, including any past the first 2000 listed in ran

Changes

No recorded changes to this operation across all 1 revision of this API.