Validate Rule

A candidate document to check without storing it.

event_types is optional because a client may be checking a document alone, but a client that has them should send them: an empty or unknown event type is a property of the rule rather than of the document, and this is the only place that can report it before a save.

A document that parsed and checked out, and why it may still notify nobody.

warnings non-empty means the document is savable but cannot be activated: it is well formed and inert. A document that does not validate never reaches this model — it is a 422.

explanation reads the candidate back before anything stores it, which is the point at which an author can still tell that the document is not the rule they meant.