Skip to content

Human commands: release, remit, suspend

The Human Verbs release, remit, suspend as CLI commands, with inputs, result, refusals and an example.

Reference for Human, one group of Human commands.

Human.release

Release frees a held amount for payout once its Dispute closes or its clearance period ends. Verb page.

Text
npx startup-builder do Human.release --json '<input>' [--try | --send | --do]

Emits Human.released.

Inputs

InputTypeRequiredDescription
humanHumanrequiredThe payee.
causestringrequiredThe Order or Dispute whose hold ends.

Returns

OutputTypeRequiredDescription
humanHumanrequiredThe payee, with the hold removed.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Human.release --json '{"human":"human_EeCsrv4AOW","cause":"Example cause"}'

Human.remit

Remit pays a supplying Human’s earned balance to their bank account through the Startup’s payment account. Verb page.

Text
npx startup-builder do Human.remit --json '<input>' [--try | --send | --do]

Emits Human.remitted.

Inputs

InputTypeRequiredDescription
humanHumanrequiredThe Human to pay.
amountmoneyThe amount. Defaults to the full earned balance.

Returns

OutputTypeRequiredDescription
transactionTransactionrequiredThe payout Transaction.
humanHumanrequiredThe Human paid, with the balance now zero.

Refuses when

CheckErrorFixThen call
The operation is part of an Offer the caller has not accepted or paid for.payment-requiredAccept the Offer named in the response, then retry the call.Offer.accept
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Human.remit --json '{"human":"human_EeCsrv4AOW"}'

Human.suspend

Suspend stops a supplying Human from taking new Tasks while a Credential lapses or a dispute is open. Verb page.

Text
npx startup-builder do Human.suspend --json '<input>' [--try | --send | --do]

Emits Human.suspended.

Inputs

InputTypeRequiredDescription
humanHumanrequiredThe Human to suspend.
reasontextrequiredWhy the Human stops.

Returns

OutputTypeRequiredDescription
humanHumanrequiredThe suspended Human.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.
The record is not in a state that allows this Verb, so the call is refused.refusedRead the record, run the Verb that moves it to an allowed state, then retry.None.

Example

Terminal
npx startup-builder do Human.suspend --json '{"human":"human_EeCsrv4AOW","reason":"Example reason"}'