docs: add query conditions reference to programmatic-table-requests skill#34
Open
Ethan-Arrowood wants to merge 2 commits into
Open
docs: add query conditions reference to programmatic-table-requests skill#34Ethan-Arrowood wants to merge 2 commits into
Ethan-Arrowood wants to merge 2 commits into
Conversation
The skill only documented URL/FIQL query string syntax. Agents writing custom resources had no reference for the programmatic conditions API, including the exact comparator strings (equals, greater_than, etc.) which differ from the FIQL equivalents and are critical for queries to work at all. Adds a full reference for the conditions object shape, all comparator values, query object parameters, and annotated examples covering common patterns (simple filter, AND+OR, relationship traversal, sort+paginate). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Conditions/comparators are only relevant when using the JS table API (search, get, subscribe) — not URL queries. Moved the full conditions reference (shape, comparator table, query params, examples) to programmatic-table-requests.md and restored querying-rest-apis.md to URL/FIQL-only content. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Ethan-Arrowood
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
programmatic-table-requests.md— the right home since conditions are only relevant when using the JS table API (search(),get(),subscribe()) inside custom resourcesconditionsarray shape (attribute,value,comparator,operator, nestedconditions)equals,not_equal,greater_than,greater_than_equal,less_than,less_than_equal,starts_with,contains,ends_with,between) — these differ from URL/FIQL syntax and must be exactlimit,offset,select,sort)querying-rest-apis.mdis unchanged (URL/FIQL syntax only)Motivation
An agent failed to build working queries inside a custom resource because there was no reference for the programmatic conditions API. The comparator names (
equals,greater_than, etc.) differ from URL/FIQL equivalents (eq,gt) and incorrect names silently fail.Test plan
search()streaming pattern🤖 Generated with Claude Code