Skip to content

Agreement programs: update

The Agreement Verbs update as MCP do programs, with inputs, result, refusals and an example.

Reference for Agreement, one group of Agreement programs.

Agreement.update

Changes the given properties of an Agreement. Verb page.

Text
do: return await $.Agreement.update(input)

Emits Agreement.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Agreement.
termtextHow long it runs and how it ends.
signedAtdatetimeWhen the last Party signed.
terminatedAtdatetimeWhen it ended under its term; it stays on record.
payoutSchedulestringFor a Supplier’s Agreement: how often the released earned balance pays out.
clearanceDaysintegerFor a Supplier’s Agreement: days an Order’s earnings wait after confirmation before they can pay out.

Returns

OutputTypeRequiredDescription
agreementAgreementrequiredThe Agreement.

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

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Agreement.update({ id: 'agreement_zHIUnX8LwY', signedAt: '2026-10-22T12:00:00Z' })"
  }
}