Skip to content

docs(openapi): formsRowsList filter parity + list_form_submissions - #21

Merged
S4Mi merged 1 commit into
devfrom
feat/forms-rows-list-filters
Aug 10, 2026
Merged

docs(openapi): formsRowsList filter parity + list_form_submissions#21
S4Mi merged 1 commit into
devfrom
feat/forms-rows-list-filters

Conversation

@S4Mi

@S4Mi S4Mi commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document GET /v3.0/forms/{slug}/rows/ (formsRowsList) with dashboard-real filters: pagination, search, sort_by, status, meta (created_by/updated_by/tags/…), submit_time/created_at/updated_at ranges, and dynamic {fieldSlug} / {fieldSlug}_{operator} filters (RowQueryUtils).
  • Add top_fields to PaginatedRowList (table columns ~= form fields).
  • Fix ?seach= typo in block content docs.
  • MCP contract: advertise list_form_submissions with compatibility aliases (list_form_rows, list_rows, …).

Review note

During review, I corrected the dynamic field filter docs to match RowQueryUtils: supported suffixes are contains/has/equal/exact/lt/lte/gt/gte plus not_ variants. Comma-separated bare field values become list filters; there is no _in, not_in, or is_equal suffix.

Current status

  • Rebased onto latest dev (6dd718f) on 2026-08-10.
  • GitHub reports this branch is mergeable; current mergeable state is unstable because checks are not clean/published yet. The connector did not return workflow runs for the head SHA.

Test plan

  • ./generate.sh
  • Generated public + MCP specs include new query params and top_fields
  • Checked row filter operator wording against formz_core RowQueryUtils / FormRowsView
  • Spot-check formsRowsList docs in HTML after deploy

@S4Mi S4Mi self-assigned this Aug 6, 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 feat/forms-rows-list-filters branch 2 times, most recently from 9150f98 to 530d0cc Compare August 10, 2026 18:22
Align GET /v3.0/forms/{slug}/rows/ with dashboard and RowQueryUtils filters
(status, meta, date ranges, dynamic fieldSlug operators), surface top_fields,
fix the ?seach typo, and advertise list_form_submissions in the MCP contract.

Co-authored-by: Cursor <cursoragent@cursor.com>
@S4Mi
S4Mi force-pushed the feat/forms-rows-list-filters branch from 530d0cc to 64c9cc6 Compare August 10, 2026 18:33
@S4Mi
S4Mi merged commit 9396b18 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