HTTP API

Resources, Models, and Controller Overrides

Serialization customization and extension points.

Resource customization

Config keys:

formforge.http.resources.form_definition
formforge.http.resources.submission
formforge.http.resources.submitter
formforge.http.resources.file_urls.*

File URL options:

enabled
temporary
ttl_seconds
key

Model overrides

Overridable keys under formforge.models.*:

form_definition
form_category
form_submission
submission_file
staged_upload
idempotency_key
form_draft
submission_automation_run
submission_privacy_policy
submission_privacy_override

Each custom model must extend the corresponding package base model.

Controller overrides

Config keys:

formforge.http.controllers.schema
formforge.http.controllers.submission
formforge.http.controllers.upload
formforge.http.controllers.resolve
formforge.http.controllers.draft
formforge.http.controllers.management

Rules:

extend the package controller
keep method signatures compatible
call package services instead of duplicating business logic

Scoped Routes and Ownership

Owner-context routing and polymorphic ownership strategies.

Query Routes

Configure reusable form and category listing routes with nested AND/OR predicates.