The module configuration payload only accepts two top-level keys: title and fields. Any other key — description, blocksMovement, slug, uiComponent, active, or rules — is rejected with a 400 error.
No item in fields should include the active key, even though the configuration query returns that information for each field — resending it is rejected with a 400 error on both creation and update.
Options for select-type fields (select, radio, checkList) are always a plain list of strings (["Yes", "No"]) — never an object with label and value.
The opinion configuration is unique per flow, not per phase, even though the API path includes a phase identifier. To use the opinion on multiple phases of the same flow, create the configuration once and enable the module on each phase through the corresponding phase action.
When the flow does not yet have an opinion configured, the configuration query returns success with an empty body, rather than a not-found error.
Creating the module configuration alone is not enough for the opinion to appear to users on the phase — the module must also be enabled through a phase action with action: opinion.
Updating the configuration (PUT) fully replaces the list of complementary fields. Resending an existing field requires its original id; omitting it does not permanently remove it — the API marks the field as inactive (soft delete). When building the update payload from a previous query, discard fields that are already inactive before resending.
When registering a card's opinion, value (the approved value) is required whenever status is approved — its absence is rejected.
Registering a card's opinion does not accept the limit or comment keys.
Complementary field values in the card's opinion are identified by each field's id (obtained from the module configuration), not by name. For select-type fields, the value is always sent as an array, even when only one option is selected.
A second opinion creation call for the same card and phase fails, since the opinion already exists — use the update call to revise it.
