banking.v1.FeesService

AcknowledgeUndeliveredNotices

Take responsibility for the holders of a scheduled change who could not be told (AllocationManage, AND the caller must be the one who requested the change or a fund owner). A change that TIGHTENS the terms does not bind while a holder's notice is undelivered; for a holder the identity plane can never reach that is forever. This records who acknowledged, when, and exactly which holders' notices the mailer had GIVEN UP on by that moment (notices_given_up, never a notice still being tried), and the change then binds over those holders — and over nobody else who turns out untold later. A later call ADDS the holders given up on since (notices_unacknowledged) and stands as the latest: its caller and moment replace the record's, taking responsibility for the whole list. A repeat that would add nobody returns the record unchanged. ALREADY_EXISTS when the change is not scheduled, only loosens the terms (it binds by itself), or has no notice given up on yet that is not already covered — there is nothing to take responsibility for; PERMISSION_DENIED for a caller who is neither the requester nor an owner.

post/banking.v1.FeesService/AcknowledgeUndeliveredNotices

Request

  • The document declares no server URL.
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

servicestring
change_idstring

Response

Success

idstring
servicestring
versioninteger
statestring
management_bpsinteger
performance_bpsinteger
hurdle_bpsinteger
basisstring
crystallizationstring
requirementstring
consilium_idstring

The consilium this change waits on (or waited on); empty for an administrator's change.

requested_bystring
reasonstring

Why, in the requester's words; empty when none was given.

notices_waived_bystring

The operator's acknowledgement of holders who could not be told (see AcknowledgeUndeliveredNotices): who took responsibility — the latest to, when the record was extended — governance detail, shown to operators and blank for everyone else.

notices_waived_usersstring[]

The ids of the holders whose notice the mailer had given up on by that moment — the holders the change binds over untold. Operators only; empty for everyone else.

undelivered_noticesinteger

Notices of this change not yet delivered to a CURRENT holder, how many of those the mailer has given up on — the figures a tightening waits on — and how many of the given-up ones the acknowledgement does not cover (all of them while there is none): the holders a (further) AcknowledgeUndeliveredNotices would name, so it is worth offering exactly while this is non-zero. Counted only while scheduled (0 in every other state), and shown to operators only.

notices_given_upinteger
notices_unacknowledgedinteger

Changes

Changes to this operation have not been checked yet.