List records
heliyos_records_listLists companies, people, deals, or custom object records in a Heliyos workspace, newest first, so you can browse and filter CRM data with search, field filters, and sort.
Instructions
Lists records of one object (companies, people, deals, or a custom object) in the Heliyos workspace, newest first. Use it to browse or filter records; use heliyos_records_lookup to find a record by name and heliyos_records_get for one record. Filter with search (free text) and filters (field conditions joined by match); order with sort. Returns a table of id, name and key fields plus structuredContent {records:[{id, object_type, name, fields}], next_cursor}. When next_cursor is present, call again with cursor set to it for the next page. Record ids feed heliyos_records_get, _update and _delete.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"object_type": "<object_type>"
},
"name": "heliyos_records_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. Omit for newest updated first. With a sort, next_cursor is a page cursor from this tool; pass it back unchanged. | |
| limit | No | Records per page, 1 to 100. Default 20. | |
| match | No | "all" (default): a record must meet every filter condition. "any": at least one condition. | all |
| cursor | No | next_cursor from the previous page, with the same limit. Omit for the first page. | |
| search | No | Plain words matched across the record's text fields. Symbols such as + ( ) [ ] * ? can cause an error. | |
| filters | No | Field conditions, for example [{field:"stage", operator:"equals", value:"Won"}]. Joined by `match`. | |
| schema_id | No | Object schema id. Required when object_type is "custom"; the error lists the available ones. | |
| object_type | Yes | Which object: "company", "person", "deal", or "custom" (custom objects also need schema_id). | |
| response_format | No | "concise" (default) returns the name and key fields; "detailed" returns every field and linked records. | concise |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| records | Yes | ||
| next_cursor | No |