Filter Records

Filter records by field values

Parameters

ParameterTypeRequiredDescription
app_idnumberRequiredThe app to filter
filtersarrayRequiredArray of filter objects. Each filter: {field_id: "123", field_type: "single_text", match_type: "contains", values: [{value: "search term"}], type: "text"}
limitnumberOptionalMax records to return (default 30)
cursorstringOptionalPagination cursor
sort_bystringOptionalExternal ID of field to sort by
sort_descbooleanOptionalSort descending (default false)

Examples

MCP Tool Call

{
  "name": "tape_filterRecords",
  "arguments": {
    "app_id": 12345,
    "filters": "example",
    "limit": 12345,
    "cursor": "example",
    "sort_by": "example",
    "sort_desc": true,
    "count_only": true,
    "field_ids": "value",
    "field_values_only": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/tape/filterRecords \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": 12345,
  "filters": "example",
  "limit": 12345,
  "cursor": "example",
  "sort_by": "example",
  "sort_desc": true,
  "count_only": true,
  "field_ids": "value",
  "field_values_only": true
}'