The title sent on creation (POST) is ignored by the API, which always returns "Ficha Cadastral". To customize the title, the form must be updated after creation — from that update onward, the title is respected.
createButtonLabel is required both on creation and on metadata updates, and cannot be an empty string.
backgroundColor must be sent explicitly on every metadata update — if omitted, the API resets the color to the platform default, discarding the company's custom color without warning.
When updating the form's fields, every existing field must keep its original id. Omitting it makes the API treat the field as new, creating an inactive duplicate instead of updating the intended field. New fields also need a client-side generated identifier (UUID) before sending.
Options for select-type fields (select, radio, checkList) are always a plain list of strings — never label/value pairs.
Visual grouping into sections is done per field, through sectionMetadata — there is no separate sections array.
Conditional rules (show, hide, set required, set optional, clear value, set value, or automatically calculate) are defined through a dedicated call, and are preserved across subsequent field updates, as long as the identifiers of the referenced fields do not change.
Setting new conditional rules clears the help text (help) on every field of the form, as a side effect. We recommend always finishing the form's configuration with a field update that includes the help text.
If the value used in a condition does not exactly match an option registered on a select-type field (including accents and spacing), the corresponding rule will never fire, without producing any error.
Reading the public version of the form is the only endpoint in this domain accessible outside of an authenticated user session, and it requires the ag-flow-id header with the flow identifier.
Deleting the form is destructive: the flow is left without an entry form until a new one is created. Before deleting it, we recommend checking for triggers, credit/decision engines and document templates that reference fields of the form.
