Skip to content

docs: add Ministry Platform query syntax reference#62

Merged
chriskehayias merged 1 commit into
mainfrom
docs/mp-query-syntax-reference
May 17, 2026
Merged

docs: add Ministry Platform query syntax reference#62
chriskehayias merged 1 commit into
mainfrom
docs/mp-query-syntax-reference

Conversation

@chriskehayias

Copy link
Copy Markdown
Contributor

Summary

  • Adds .claude/references/ministryplatform.query-syntax.md documenting the SQL-style syntax accepted by the MP /tables/{table}/get endpoint (filters, aggregates, groupby/having, sorting, pagination, distinct, dp_fileUniqueId selection).
  • Documents the two _TABLE FK traversal rules that produce the most opaque MP errors — ambiguous-column failures when any clause joins, and the dotted-vs-underscore-concatenated multi-hop path syntax — with a worked example and an error-to-fix lookup table.
  • Links the new reference from CLAUDE.md in the Reference Documents section.

Test plan

  • Reference file renders correctly in Markdown
  • CLAUDE.md link points to the new file
  • (No code changes — no build/test impact)

🤖 Generated with Claude Code

Captures SQL-style syntax accepted by /tables/{table}/get — filters,
aggregates, groupby/having, pagination, and the two _TABLE FK traversal
rules that produce the most opaque MP errors (ambiguous columns when
joining, dotted vs underscore-concatenated multi-hop paths). Includes a
worked example and an error-to-fix lookup table. Linked from CLAUDE.md
Reference Documents.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@chriskehayias chriskehayias merged commit 4c6bfff into main May 17, 2026
1 check passed
@chriskehayias chriskehayias deleted the docs/mp-query-syntax-reference branch May 17, 2026 12:37
@codecov

codecov Bot commented May 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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