Skip to content

Mandate programs: revoke, spend

The Mandate Verbs revoke, spend as MCP do programs, with inputs, result, refusals and an example.

Reference for Mandate, one group of Mandate programs.

Mandate.revoke

Revoke ends a Mandate at once, so new Actions under it are refused and running ones finish. Verb page.

Text
do: return await $.Mandate.revoke(input)

Emits Mandate.revoked.

Inputs

InputTypeRequiredDescription
mandateMandaterequiredThe Mandate to end.

Returns

OutputTypeRequiredDescription
mandateMandaterequiredThe revoked Mandate.

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

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Mandate.revoke({ mandate: 'mandate_mKKPrmFQYD' })"
  }
}

Mandate.spend

Spend pays an outside party for a Startup with a single-use card, within a Mandate and its Limit. Verb page.

Text
do: return await $.Mandate.spend(input)

Emits Mandate.spent.

Inputs

InputTypeRequiredDescription
mandateMandaterequiredThe Mandate that covers the purchase.
amountmoneyrequiredThe amount to spend.
payeestringrequiredWho is paid.

Returns

OutputTypeRequiredDescription
transactionTransactionrequiredThe card Transaction.
mandateMandaterequiredThe Mandate with its remaining Limit.

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

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Mandate.spend({ mandate: 'mandate_mKKPrmFQYD', amount: { amount: 29, currency: 'USD' }, payee: 'Example payee' })"
  }
}