Actions28
- Chat Actions
- Chat History Actions
- Memory Actions
- Record Actions
- Record Schema Actions
- Claim Actions
Record → Query
AI-generatedSummary
Query records by type with exact‑match filter, optional sorting and pagination.
Inputs
- recordType (required) — Record type name (e.g., "account")
- recordQueryWhereJson — Exact‑match filter JSON object; all specified fields must match
- recordQueryOrderBy — Field to sort by; prefix with '-' for descending
- recordQueryLimit — Maximum number of records to return
- recordQueryOffset — Pagination offset
- recordSubjectHeader — Optional subject ID to send as x‑subject‑id for access‑control
Output shape
array of items, each containing the query result data
Result array respects limit/offset; may be empty; errors are thrown rather than returned
Examples
Example 1: Retrieve active accounts limited to 20, sorted by created_at descending
recordType = "account", recordQueryWhereJson = {"status":"active"}, recordQueryOrderBy = "-created_at", recordQueryLimit = 20
Example 2: Paginate through records of type "deal" starting at offset 50, limit 50
recordType = "deal", recordQueryWhereJson = {"type":"sale"}, recordQueryOffset = 50, recordQueryLimit = 50
Example 3: Query with ACL using a specific subject header
recordSubjectHeader = "subject_123", recordType = "ticket", recordQueryWhereJson = {"priority":"high"}