Skip to content

docs(openapi): deprecate legacy form fields; clarify submit/theme contracts - #20

Merged
S4Mi merged 2 commits into
devfrom
fix/lotr-openapi-agent-contracts
Aug 10, 2026
Merged

docs(openapi): deprecate legacy form fields; clarify submit/theme contracts#20
S4Mi merged 2 commits into
devfrom
fix/lotr-openapi-agent-contracts

Conversation

@S4Mi

@S4Mi S4Mi commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Normalize OpenAPI: deprecate form-level needs_login and form.form_type; keep theme.form_type as canonical (simple | multi_step).
  • Clarify theme_config.font_size enum small|medium|large and renderer default behavior.
  • Document form-display submit uses display slug (not address); field keys are slugs unless submit_by_alias=true.

MCP sync note

After this lands and docs artifacts are regenerated/published, FormalooMCP picks up via node scripts/sync-openapi.mjs and .github/workflows/openapi-sync.yml.

Current status

  • Rebased onto latest dev (6dd718f) on 2026-08-10.
  • GitHub reports this branch is mergeable and clean.

Test plan

  • ./generate.sh
  • Spot-checked frontend/backend source references for theme_config.font_size, submit_by_alias, and form-display slug/address routes
  • Spot-check CreateForm / FormTheme / SubmitFormRequest descriptions in hosted docs after deploy

@S4Mi S4Mi self-assigned this Aug 5, 2026
@S4Mi
S4Mi changed the base branch from master to dev August 6, 2026 00:08
@S4Mi
S4Mi requested a review from xishma August 6, 2026 00:08
@S4Mi
S4Mi force-pushed the fix/lotr-openapi-agent-contracts branch from fa77674 to 9707029 Compare August 6, 2026 00:14
S4Mi and others added 2 commits August 10, 2026 14:20
…contracts

Mark form-level needs_login and form_type as deprecated, keep
theme.form_type and font_size enum as the agent-facing source of truth,
and document display-slug submit with slug vs alias field keys.

Co-authored-by: Cursor <cursoragent@cursor.com>
Match dashboard/form-ui FontSizeEnum (small|medium|large). Backend theme_config is free-form JSON; medium is the renderer default when omitted.

Co-authored-by: Cursor <cursoragent@cursor.com>
@S4Mi
S4Mi force-pushed the fix/lotr-openapi-agent-contracts branch from 9707029 to 51dd214 Compare August 10, 2026 18:21
@S4Mi
S4Mi merged commit 763c1aa into dev Aug 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant