HomeGuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceDiscussions

Events Schemas & Definitions - ALL WIP

Defined Types


Standard HTTP error codes


ValueDefinitionAuto Retry?Manual Retry?
EMITTEDThe state of an event after it is first sent by the BONS HTTP/S agent but before the listener has responded with a status.NOYES
ACKNOWLEDGEDThe state of an event when a listener responds with a 200 to the emission of an event for an asynchronous subscription.NONO
PROCESSINGThe state of an event when updated by an asynchronous response from a listener. This state can be used when an event triggers complex or long-running business processes that may succeed or fail at a later time.NONO
SUCCEEDEDThe state of an event when updated by an asynchronous response from a listener to indicate that downstream processing has completed successfully and that there is no need for a retry from Blend.NOYES
FAILEDThis state is set when a listener responds with any code outside of the 2xx range synchronously or asynchronously through an event state update.YESYES
NO_ACTIONThis state may be used if, for example, you wish to subscribe to a large set of events but only have the development bandwidth to process a smaller subset of them. You may provide a 204 response on the original call or asynchronously respond with a "NO_ACTION" state update event to halt further retries. This is an ideal solution for enabling faster iterative development.NOYES
QUEUEDThis state is used to denote the time between when an event is generated by one of Blend's microservices and when it is prepared and ready to be dispatched to a subscriber. During this time, no retries or alterations may be made to the event record and no updates may be posted.NONO
INVALIDThis state is used to denote an invalid transmission and may be used with an asynchronous state event only. This state is not retryable and is generally not suggested for use outside of development environments.NONO
CANCELLEDThis state is set by an asynchronous state event and is used to describe an event which, at some point during downstream asynchronous processing, has become unneeded. For example, if your systems are processing several disclosures-related events simultaneously and then your receive a notification that the party has declined the disclosure package, you may wish to invalidate all outstanding events to avoid retries.NOYES
DISABLEDThis state is set by an asynchronous state event and is used to denote that a subscriber has disable processing on a specific event class. This is a good way to gracefully deprecate the processing of certain events within your listeners without having to work with your Account Manager or Deployment Engineer.NOYES